EDM Backup 
Configuration 
File 



The backup configuration file (/usr/epoch/EB/config/eb.cfg) on 
rhe EDM Backup server defines how backups run at your site. 
The configuration interface stores its data in llie cb.cfg file. 

You configure your EDM backups using the Backup Configu- 
ration wizard, and you tailor your configurations to your needs 
by using the EDM Backup Configuration window. (Avok] 
manually editing the configuration file.) \X'hen you do not have 
access to tlie graphical interface (such as when dialing in), you 
can use the interactive command line interface, eb_config. 



WARNING: Manually editing the eb.cfg file risks 
corrupting the backup configuration. 



This chapter describes tlie statements Vs'ithin ihe configuration 
file. These .statements correspond to windows and fields in the 
EDM Backup Configuration wizard and window, but they do 
not match exactly in wording or in number. Tliis chaj^ter does 
not decribe Symmetrix Path, Symmetrix Connect, or new 
database clients. 
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'Hie topics in this chapter include: 

• General Coding Rules 

• Sumniaiy of Melds 
" Sen-er Fields 

" Woj'k Group Fields 

• Filesysrem Work Item l^lelds 
" Database Work Item Fields 
» FC Work Item Fields 

» Backup Trailsets 



GenSral Coding Rules M you must edit the configuration file, follow these general 

editing rules: 

Note: llie EDM Backup Configuration window reformats 
ilie eb.cfg file. If you edit eb.cfg directly, you lose 
comments and spacing the next time you run the 
interface. The EDM Backup Configuration window- 
reads in C pre -processor #include .statements. 

» 'I'he configuration file is made up of nested sets of blocks; a 
set of curly braces ( ) delimits each block. Make .sure to 
use these l^races in pairs. For each open brace, diere mu.st 
be a closing brace. 

• If you include multiple conflicting specifications for any 
given field, tlie last specification is used in m(xst situations, 
unless otherwise noted in this chaptei-. 

• U.se a .semicolon (;) to tenninate entries that do not begin 
with a brace: 

work group list: "dave' s group" , "ton/ s group"; 

» Separate multiple strings by using a comma and optional 
spaces: 

authorized backup list: "cadi", "cad2", "cad3", 
"atlas2"; 

• Do nor use die line-continuation character (\). 
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Any comments ai'e delimited using paired slash-asieiisk 
cliaracters: /"comments"/. Comments should not span lines. 
Place double quotes around sMngs, \\'here a string is any 
non-ntimeric value except the resei'ved ^vords that are 
described in the next bullet, 
client backup username; "ebadrnin"; 

Each quoted string must be complete on a single line: 
stiings cannot span lines. Make sure to specify each string 
by using llie correct case (capitalization), EIDiVl Backup is 
case-sensitive when inteipreting strings. 
Some i-esej-ved words do not require quotes; you can enter 
them as Follows; 

- Always use the standard three-character abbreviation 
when specijying a month. Use all lowej-case characters, 
or uppercase the first ciraracter only (for example, mar 
or Mar). 

- Specify units oi' lime as hows, minutes., seconds, days, 
weeks, etc., as descrited for each field. ./Uways ase 
lowercase characters when specifying units of time. 
Spell out days of the week completely. Use all 
lowercase characters, or uppercase die first character 
only (for example, Sunday or Sunday). 

- Specify units of computer storage as follows: KB or K: 
MB or M; or GB or G (lowercase or upperca.se). 



Checking Your Changes if you do edit the configuration file, you always must check 

aftenvard for syntax errors. To do this, run ebbackup with 
the -check option, litis causes ebbackup to report any syntax 
errors.' 



1. I nder certain unusual condilions, some systax errors wili not be delected 
until lire actual liiickup is run. 
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As necessary, edit die file to conect the errors, and tlien run the 
check again. Repeat tliis process until no more errors are 
j^resent. 



WhSfl ChangSS Tske Effect when you cliange various configuration parameters, changes 

eitlier; 

» take elTect immediately on your system (even as backups 

are being processed), or 
• take elTect tlie next time ebbackup processing is started, 

eitlier from an entry in root's crontab file or by issuing the 

ebbackiip command manually 

This does not include the next time ebbackup autcjscheduling- 
only (-sched option) oj- checking (-check option) is started. 
Any exceptions are noted in the discussions. 



Summary of Fields Table B-l .summarizes the fields in the configuraticjn file, li 

includes a brief desci-iption of each field, tlien tells whether tlie 
field is required (Req column), the field length and range of 
possible vahies, the initial value at in,sta]lation, and wlien a 
change to the field takes effect. 
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The fields ai-e presented genei-ally m the oixler that lliey appear 
in the file. 



Table B-1 Summary of Fields in the Configuration File 



Field 


Description 


Req 


Size or Values 


Initial Setting 


Takes Effect 

Now Next 
Bkup 


Sej-ver Block Fields 


ebserver 


Name ol the E13M Backup 
seiver 


yes 


]-(^3 char 


seiver-name 




cJienl backup 


Login name used when 
ebbackup connecis with client 




]-63 char 


ebadmin 


✓ 


backup 
usernames 


Individuals who are responsible 
for EDM Backup, and who have 

RDM Backup environment 




1-63 char 
(per user) 




✓ 


authorized 
backup list 


Client systems that are backed 
up by the l-.DM Backup seiner 


yes 


1-63 char 
(per client) 




✓ 


authorized 
recoveiy list 


Usei-s who can resiO]-e files 
backed up from theii' own client 
(known as a self-seivice restore) 


no 


client-.nser 
combinations 


none 


next 
restore 


authorized cross 


Users who can restore files to 
clients other tlian those Trom 
which the backup files origi- 
nated 


no 


dienP.user 
combinations 




next 


recovejy 
adniiflistratoj' list 


Users who can restore files 
other than their own to the 
client from which the files were 
originally backed up 


no 


clienhtiser 
combinations 




next 
restore 


simultaneous 
clients 


Global maximum 
number of clients that are 
backed up concuirentlv across 
all trails 


yes 


in the range 1-64 




✓ 
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Summary of Fields in the Configuration File (Continued) 



Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



Backup car 
lypK of met 



2 lo LI specific 
incunenily 



il ihroiitjlipui of baclsup 



maximum sen'cr Maximum size of 
backups.log file backups.log file 



linn K per hour 
nnn K per minute 
nnn K per second 
(if is K13, MB, or 
GB) 

A' or no limit 



recoveries. log 
file size 



maximum cliem 
backups.log file 



size of the s 
log file 



Maximum size of each 
client's backups.log file 



catalog tlireshold Level 0 backup is Forced for an 
to force level 0 filesystem work item when 
backup more titan this number of files 



imn K or no limit 2%KB 

(if is KB, MB, or 

GB) 

7??!n A' or no limit 64KB 

(A' is KB, MB. or 

GB) 



(if is KB. MB. ( 

GB) 



number of files; 0 0 
disables this feature 



next backup 
for the client 



next backup 
for the client 



Work Group Field 



Name of the work group 



File System Work Iten 
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Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



Nunu o! tin- woik iiem 
cheni backt d up b\ rhe 



Name ol one oi- more 
client directories, filesys 
file^ thai lective'; k\e] i 
backu]3s via this work n 



Same as abo\ t. but list: 
local client diiectoric 
files) stems m liSM systen 
tecei^e a baseline backup 



migration backup lag used to cross- 
tag relei ence a migration store on 
the ser\'e)' with the migration- 
client files Irom which the store 
was created (applicable when 
backing up staged files h'om the 



I-63 char (each, per 
work item & client 
name) 

pathnames and 

optional 

fiiidxcpio 

qualifiers (no 
size limit) 

same -asfilespec 



1-63 char; first 16 
must be unique 



connection \ 



Marker that identifies work 
items that should not be backi 
up concun'ently 

Specifies ihe use oi an alterna 
network port lor a work item 
a multiple nttwoiked client. 

Pnoiily at \Ahich the work ite 
should run 



alternate port name, 
must be a valid 
client name 

in the range 

-25 (ran first) to 50 



Statement used to exclude the Jio as stated 
Vi'ork Item horn load balancing 
(so no extra knel-0 backups are 



statement 
omitted (load 
balance) 
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Table B-1 Summary of Fields in the Configuration File (Continued) 



Field 


Description Req 


Size or Values 


Initial Setting 


Takes Effect 

Now Next 
Bkup 


c„n.pletene. 


Code used to limii ilie numlier no 
ol' files for which ilic dala 

media (applicable lor files 
under migi-ation control, to 
avoid performing excessive 
backups) 


all files 

resident files only 

files not backed up 
in migration store 

non-baselined files 


varies b\ diem 


✓ 


level map 


Mapping lietween backuji no 
levels thai 

ncjrmally occur (based on the 
template used) and the level 


12-char string: 

example; 
"Bx0xxxxxxxx9" 


"Bx()r23456789" 


✓ 


maximum files 
not backed up 
befoj-e forcing 
full backup 


Level 0 backup is forced for the no 
filesystem work item when 
more than this number of files 
in tlie work item hnve never 
been backed up 


number of files; U 
disables this feature 


0 


✓ 



Database Work Item Fields 

These "Database Worlc Items" pertain to the "offline database backup'' fimctionality supported prior to EDM 4.4.(3 
and are included here to support restores only. They do not ap]3ly to riie database fiackup clients curremly 
supported for backup. 



work item Name of the work item, the yes 


1-63 char (each, per none 


✓ 


client backed up by the work 


work item & client 






name) 




filespec Name of one or more yes 


pathnames and none 


✓ 


client directories, filesvstems, or 


optional 




files that receives level 0-9 


fiiidxcpio 




backups via this work item 


qualifiers (no 






size limit) 




database type Type of database to be sliut yes 


oracle, inforinix, none 


✓ 


down 


Sybase 
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Table B-1 Summary of Fields in the Configuration File (Continued) 



Field Description Req Size or Values Initial Setting Takes Effect 

Now Next 
Bkup 



database server Name of the database server for yes server name nojie ✓ 

the work item 

database name Name of dataljascf s) found yes database names none ✓ 
during configuration 

lype Tyj^e of work item yes coordinated coordinated %/ 

use connection Defines the TCP/IP |3on on yes socket®/w;Y sockei@'0 ✓ 

metiiod which the client is 

listening foi' a command from 

the EDM Backup server. Do not 

use lor kicker work items 

backup client Script to be nm on ilie client yes See "f3atabase Work none ✓ 
initialization before shutdown Item rields" on page 

command B-50 

backup client Script to be nin on the client yes See "13atabase Work none ✓ 
cleanup after restart Item I'ields" on page 

command B-50 

backaip client Data butter sizes on client and yes 0-32 MB 0 MB ✓ 

data biifl'er size servers 

back-tip server yes 0-32 MB 0 MB ✓ 

data buffer size 

recovery client yes 0-32 MB 0 MB ✓ 

data buffer size 

recoveiy sen'er yes 0-32 MB 0 MB ✓ 

data buffer size 



PC Work Item Fields 

These fields are used for ail PC clients: NetWare, Windows NT, and OS/2 and for OpcnVMS Clients. 
In several cases the word netware is embedded in the code, but the field is used for all PC clients. 
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Summary of Fields in the Configuration File (Continued) 



Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



client i.iacked up by ilie woj-k 
item 

Name of one or more 
client directories, filesystems, oi 
files that recci\'es level 0-9 
backups via this wcirk item 



findxcpio 

qualifiers (m 



Requi 
gener 



single-ihreaded 
cessingfor the client. 



DOS. 

Defines the TCP/IV port on 



netwaie@/)Or/ 
(see "Conneci 
Method'' on p 
B-57) 



;tware®1492 
r OS/2, 



encrypted 
password 



, what userpriviicge 
e backii]3s and 



Enciypted pas.swojd lc;i 
netware usernanie 



netware® 3B96 
for Open VMS 



1-63 chars none 
(for NT; max 20 
characters) 

not editable directly, none 
Enter from EDM 
Backup Configu- 
ration window 



.FileSvstem 
(.local for OS2) 
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Table B-1 




Summary of Fields in the Configuration File (Continued) 


Field 


Description 


Req Size or Values Initial Setting Takes Effect 

Now Next 
Bkup 


nem'are client 
target 


Defines the l^C clien 
in need of seivice 


t as a target yes client name none ✓ 


Backup Trail set 


(Media Set) I'iekls 





for tlic 
maxi 



e of the irailsei 
le and type of me 



jdia u 



'I of backuiDs 
to the trail, and the 
jm numfier oi work 
lat can be backed up 



use level n for 
baseline bacl<ups 



1-63 char 
name: 1-11 char 
type: mediajype 
level: 0-9, Bl, B2 
max clients: 1-24 
Bl or B2 



keep backup 
catalogs 



keep savi 
records 



calile with lockups of MSM 
systems that are scheduled 
automatically) 

Retentioji pei iod for the baclsup 
media, qualified by level (0-9) 



Retention peiiod for backup r 
catalogs, qualified by level (0-9) 



, ;riod lor sa\'eset 
records, qualified by level (0-9. 
B1,B2) 

Backup le\^el at which EDM 
BackujT sltould 
consolidate catalogs 



{months is seconds, 
days, weeks, 
months, or years) 

same as for keep 

same as for keep 
backups 



scheduling 
occurs 



1 yr (lev 0 ) 
3 mos (lev 1-9) 



1 yr (le\' 0) 
3 mos (lev 1-9) 



1 yr (lev 0) 
3 mos Oev 1-9) 
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Table B-1 Summary of Fields in the Configuration File (Continued) 



Field Description Req Size or Values Initial Setting Takes Effect 



Now Next 
Bkup 



dupliaite media 
after backup on 


Auiomatic 
diiplicaiio 


■ media no 1 




✓ 


manual 
media dupli- 


Manual m 


icdia duplication no 




✓ 


appending lo 
cuiTeni media 
copy 


Append ti 
media for 
opposed 


D current duplicate no 
media duplication, as 




✓ 


usin£> new media 
at each dupli- 




media for each dupli- no 




✓ 



Backup Schedule Template fields 



backup 
template 


Name of the schedule template yes 


1-63 char 


default 


✓ 


woi'k group list 


Work groups that are fiacked up yes 
using this schedule template 


1-63 ciiai- (per work 
group) 


none 


✓ 


begin irailsct 


Date in Riture when f:f)M yes 
Backiip should start using the 
trail set 


dd-mmm-yy 
inm/dd/yy 
mmm dd, yy 
mmm dd, yyyy 


date 

template is 
added 


next time 
scheduling 

OCCUl'S 


rotation period 


Period of lime during which yes 
each client should receive at 
least one 
level-0 backup 


nn days 

(days is days, 
weeks, .months, or 


14 days 


next time 
scheduling 
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Summary of Fields in the Configuration File (Continued) 



Description 



Req Size or Values Initial Setting Takes Effect 



backup Name ol the script file used to 

completion sciipt store or mail backup 
completion reports 

backaip failure Name of the script file used to 
script store or mail backup failure 

reports 

do all baseline Statement used to force all 
fiackups before scheduled baseline backups to 
normal backups finish before any level 0-9 

backups start for tlie template 



statement 
omitted (don't 
force baselines 



Now Next 
Bkup 



Name of the trailset lo wJiich ^ 
backups are 

written for all the work groups 
backed up using this template 

Name of the trailset used to i 
provide an optional, second set 
of backups on alternaiing nights 
(generally only used with 
automatic 
scheduling) 

Level of logging messages 
written to the file 
specified via the seri'er log file 
field 



e of the 

template's log file (stored on the 
sei-vei- as /usr/epodi/l;B/log/ 
filename) 



none erroi-s 
stats delxig 
per file 



pathname & file size default_ 

template.log 



EDM Software Reference 



B-14 

EDM Backup Configuration File 



Summary of Fields in the Configuration File (Continued) 



Req Size or Values initial Setting Takes Effect 



Now Next 
Bkup 



Siatemenl used to je-ba 



ne co]3y is used in place 
taged-out cop)' during 



omined (do r 
baseline) 



schedule 
standard 



schedule 
lull during 
weekends 
rotations 



Statemeni used to turn on 
automatic sciieduling. and to 
schedule some portion oi the 
clients for a full backup each 
day (cannot be specified with 
full during iveeketids rotations) 

Statement used to rui'n on 
automatic scheduling, and to 
schedule all liill backups on 
Saturdays and Sundays (cannot 
be specified with standard 
rotations) 



•ekday backup Target a 



it of ti 



Backup should run each 
weekday (Monday-l-riday 
applicable with auiomalic 
scheduling to provide a 



weekend backup Target amount of t 
shift Backup should rur 

weekend day (Satu 
applicable with au 
scheduling to prov 
guideline) 



each 



in the range 1-24 



in the range 1-2-1 
houi-s 



EDM Software Reference 



B-15 



Summary of Fields 



Table B-1 Summary of Fields in the Configuration File (Continued) 



Field Description 




Req Size or Values Initial Setting 


Takes Effect 








Now Next 








Bkup 


llor work group] Statement(s) used lo 




no work grp: ] -63 char none 




custom sciieduling, ; 


and to 


scheduling 


level 11 on ... specify when to run 


the 


level: 0-9, B] . 


backups lor each Ic^ 


/el. 


or B2 




optionally qualified 




on: days 




group 










Ulays is a number |] 








or greater] within 








lite rotation, as in ]. 








3-7; or the actual 








days, as in Monday, 








Tuesday, 2nd 








Monday) 





Startup Parameters 



perform initial 


Statement used to no as stated 


statement 




full backup on 


perform the initial full backu]^ 


enabled 


scheduling 


scheduled day 


on some portion of all newly 






in.stalled 








clients each day during the first 








rotation period (applicable with 








automatic scheduling) 








Statement used to run the initial no as staled 




next time 


full backup as 


full backup on all newly- 


eirlblecr' 


scheduling 


soon as possible 


insialled clients during the first 






backup run after those clients 








are installed (applicable with 








autotnatic scheduling, and 








suggested if all new clients 








.should receive a full backup as 








soon as possible) 
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Server Fields Tlie seiver fields apply to all backup and restore operations that 

the ser\'e]- performs, Tlie sen'er block looks similar to the 
following: 



ci ient backup i 
backup adrrdnis' 



backup list: "cadi", "cad2" 
ad5" , "cade" , "docl", "doc2", 



. recovery lis 
"doc2:dave 



author !■ 
"docl :rri. 

"cad2 : ken<cad6" ; 

recovery administrator list: 



"cadl:pat 



luiTi simultaneous clients: 
.t most 2 dlt trai 
throughput to: 600k per second; 

»um server backups.log file size: 256k; 
mm server recoveries.log file size: 256k; 

client backups.log file size: 64k; 
murn client recoveries.log file size: no lim 
log threshold to force level 0: 0; 



The fields are described in order as shown abo\'e. 
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ebSCrver This field specifies tlie name of the backup seiver, and defaults 

coirecily when tlie sewer is configui-ed at insUillaiion (with tlie 
eb_server_coiilig comm an d ) ; 

ebserver: "atlasl" 



Client Baokup Username use this field to specify the l- to 64-character login name that 

ebbackup uses when it connects with client systems: 

Always use the installation default, ebadmin; this non-root user 
name is installed in /etc/password (or the NIS password map ) 
for every client and server. 

CAUTION: The ebadmin user name must have /bin/sh 
as its shell. Using any other shell causes 
installation and/ or backup failures. 

If tlie default conflicts with another login name on your 
net^ivork, use an account that is dedicated to doing backups. It 
musl be common to the server and all clients, and it cannot be a 
regular user name. 

If your site is running more than one servei', specify the same 
login name in the configuration file for each sen'er. 

CAUTION: If you change the client backup username, 
you must reinstall the client software on 
every client, including the local client on 
the server. 

Changes to tliis field take effect the next time ebbackup 
processing runs. 



Backup Administrator use this field to identify individuals who are responsible for 

Usernames edm Baciaip: 

backup adrrdnistrator usernames: "root", "jan", 
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You can specify any number of UNIX usernames (1 irj 64 
characters each, and set to "root" at inslallaiion). Each user 
whom you specify has root-like privileges uithiii the EDM 
Ba ckiip environ menl . 

The backu]3 administrators can am backuj^s and restore files 
from any client system, browse any backup catalog (regardless 
of restore permissions), ]Derform cross-restores to restore any 
data to any client, and so on. 

Note: Backup administrators do not necessarily need rcxn 
access across the entire ser\'-cr s^^stem. 

Repeat this field as many times as ycxi w-ant to add usernames. 
At a minimum, specify one name. Changes to this field take 
effect immediately. 



Authorized Backup List l Jse this list to identify those clients (w orkstations, fileservcrs, or 

backup or migration server) whose files ciin be backed up by 
this backup sender; 

authorized backup list: "cadi", "cad2", "cadS", 
"cad4", "cadS", "cad6", "docl", "doc2", 
"fijeserverl", "atlasl"; 

Each f- to 63-character client name must match: 

• the client name that is entered in the NIS map or the local 
/etc/hosts file 

• the client name thai is entered at installation. Make sure to 
u.se the expanded client name as registered in the NIS map 
(not an alias) 

and 

• the client name that is specified in the work-item field 

T^epeat this field as many tiines as you want to add client 
names, or include all the backup clients in a single list. There is 
no default backup list. Unless you specify a client name here, it 
is not backed up. 
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Changes to tliis field lake effect immediately. 



Temporarily Disabling To disable backups temporarily for a client without changing its 

Backups for a Client work-group definilion(s), remove the client's name !"rom tlris 

list. (You can .still restore files backed up from the client.) When 
you put tlie client back in the list, backups resumes normally. 



Authorized Recovery List when you add a Restore User Name to the Self Restore Permission in 

the Backup Configuration window, that user name is added to 
the authorized I'ecovery list in tlie eb.cfg file. 

You can also add user names manually to the eb.cfg file. Llse 
this field to identify users who can restore files that ai-e backed 
up from their own client system, restoring them on tlieir own 
(that is, the .same) client: 

"cad3 : eric" , "cad4 : jane" , "cad5 : tom" , "cad6;bob", 
"ciocl : mary" , "doc2 : dave" ; 

This ensures that only authoiized users can perform a self- 
service restore. Unless you specih,' this field, no users can 
restore their own files. 

Repeat this field as many times as you want to add user names, 
or include all of the specifications in a .single li.st. Backup 
administrators can always restore their ow-n files, so they should 
not be specified explicitly in this list. 

Identify each item in the list as a clientaiser pair, in this format: 

authorized recovery list: " client : user" , 

• Specify client as one of the following: 
the name of the client system 
- an asterisk ('), which indicates any client 
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As an alternative to lx>th the clieni and user names, specify 
the name of a netgroup preceded }yy an @, wliere llie 
netgroLip identifies each clientruser combination that can 
perform a self-service restore: 

authorized recovery list: "@doc"; 

• Specify user as one of tlie following: 

- the login name of the individual on that diem who has 

permission to restore files to that clieni (illustrated 

below for cadl-cad3): 
authorized recovery list: "cadi:*, "cad2:*", 
"cad3:eric"; 

an asterisk ('*), which means that any user who is 
logged into this client can restore the client's files: 
authorized recovery list: "cad6:*"; 

as an equivalent to the asterisk, omit the colon and 
username completely: 

authorized recovery list: "cad6"; 

Changes to tliis field liike effect the next time a restore runs. 

You can also disable self-sen'ice restores foi- all clients by 
leaving the list blank (or by omitting the list): 



Authorized Cross-Recovery use this field to identify users who am restore files to client 
List systems otlier than those from which the backups originated: 

authorized cross recovery list: "cadi : pat<cad4 " , 

"cad2 : ken<cad6" ; 

Users who request a cross-restore must either own the files that 
are being restored, or must have read access to those files 
under UNIX. Users must also have write and execute permis- 
sions to the destination director^'. 
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l^epeat this field as many times as you want to add user names, 
or include all the specifications in a single list. Do not include 
backup administrators in this list. Backup administrators can 
always restore from any client system to any other client system, 
regai-dless of tlie system on wliicli they are working. 

Specify the list using the formal shown below: 
authorized cross recovery list: "client: user < 
backvp_cdient" ; 

Note: Tire user requesting a cross-restore l^ecomes the 
owner of the restored files, regardless of the client 
from which they were originally backed up. An 
exception occurs if the user requesting the cross- 
restore is also a restore adminisirator, in which ca.se 
the original owner is preserved. 

» Specify cHent as the system to which files can be restored 
through a cross-restore. At restoi-e time, this must be the 
client at which the person reque,sTs the cross-restore is 
logged in. Specify: 

the name of the client system to which files can be 
restored 

- an asterisk ('), which indicates any backup client 
(illustrated below) where Pat can I'cstore any files to 
(and from) any client system); 

authorized cross recovery list: "*:pat < * " ; 

As an alternative to both the client and user names, specify 
the name of a netgroup preceded by an @, where the 
netgroup identifies each usei- that has permission to restore 
files to the clients in tlie netgroup: 

authorized cross recovery list : "@netgroupa< cad5"; 

• Specifi,' user as the name of the user authorized to initiate 
restore on the client identified to the left of the colon. You 
can specify: 
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the login name ol' the individual who has pennission to 
restore files to that client, as it appears in the autho- 
rized recoveiy list. Tlie following example gives the 
user Pat permission lo restore files that are backed up 
from cad6 to cadi: 
authorized cross recovery list: "cadlrpat <cad6"; 

an asterisk (*), which means that any user who is 
logged into the client can perform tlie cross-restore; 
authorized cross recovery list: "cadl:*< cad6"; 

as an equivalent to the asterisk, omit the colon and 
username completely: 

" Specify backup_client as one of the following: 

- the name of a client from which files were originally 
backed up (where the files can be restored to the 
indicated client:user) 

an asterisk (*), which indicates any backup client 
the name of a netgroup that is preceded by an @, to 
specify the clients in an entii'e netgroup 

The following example allows any user who is logged in to 
cadi to restO]-e files from any backup client: 

authorized cross recovery list: "cadi < *"; 

Changes to tliis field take effect the next time a restore runs. 



Disabling All Cross-Restores select Restrict cross-Restore to Clients in the Client tab in die EDM 

Backup Configuration window to disable all cross-restores, 
except those that the restore administrator list explicitly allows, 
and those diat the backup administrator performs. 

To do tliis manually in the eb.cfg file, leave tliis list blank (or 
omit tire list) to disable all cross-restores: 
authorized cross recovery list: ; 
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Recovery Administrator List 



Use this field to identify users who can restore files other than 
their own to the client from which the files were originally 
backed up; 

The user who requests the restore must be logged in to the 
client fi-om which tlie files were backed up. 

This feature is designed for use when multiple usei^s share a 
client, to enable a single user on that client to serve as the 
restore administrator for just that client. Repeat tliis field as 
many times as you want to add usernames, oi- include all the 
specifications in a single list. Backup administrators have all of 
the rights of a restore administrator, so should not be specified 
explicidy in this list. 

Identify each item in the list as a client: u,ser pain in this format: 

Note: The original owner is pre.ser\'ed for all files ihai a 
restore adminislratoi' restores. 

• Specify client as one of the following: 

- the name of the client. Tliis is the client from -ftiiich the 
files were backed Lip and to which they can be restored 
by the restore adjninistrator. 

- an asterisk (') to indicate any client: 
recovery administrator list: "*:kareri"; 

the name of a netgroup preceded by an @, where the 
netgroup identifies each client in the netgroup. 

• Specify user as the name of the restore adminisu'ator autho- 
rized to initiate restore on the client(s) indicated. You can 
specify: 

- the login name of tlie user. 

- an asterisk (') to indicate any user: 
recovery administrator list: "cadi:*"; 
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As an equivalent to the asterisk, omir the colon and 
username completely: 
recovery administrator list: "cadi"; 

Changes to this field take effect the next time a restore runs. 



Disabling AdministratOr-Leyel Leave this list blank (or omit the list) to disable all administrator- 
ReStoreS level restore functions except lliose that the authorized cross- 

recover\' list explicitly allows, and those that the backup admin- 
istrator performs: 

recovery administrator list: ; 



Maximum Simultaneous use this field to specify the global maxiinum number of work 

Clients items (not clients) the EDM Backup server can l:)ack up cojicur- 

rently, across all trails being written at any one time. 11iis field 
controls the total amount of resources the sen'er can allocate to 
backup functions, and relates to the sen-'cr's available 
processing power, memoiy, and connectivity. .Adjust this field to 
reduce or expand the system resources available for backup 
processing: 

maximum simultaneous clients: 24; 

Specify a value in the range 1-64 (set to 24 at installation). If you 
specif}' a value that is too small, EDM Backup under-utilizes 
system resources. If you specify a value that is too large, EDM 
Backup saturates the server's viraial memory, which causes 
memory thrashing and reduces performance. 

Changes to this field take effect immediately. 



Use At Most n media-type Your seiver only has a fixed number of physical drives for 

Trails Concurrently backup. Besides EDM Backup, other applications on the server 

may need to use these drives, such as the IISM server. 
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Specify one use at most field for eacli type of backii]3 media, to 
define tlie niaximujii number of drives EDM Backup can use for 
eadi device t^'pe (that is, the maximum number of ti-ails EDM 
Backup can write to that type of media at once), lliis is initially 
set to 4 for each type of device that is available to the seiver. 

This field has the format: 

use at most n media-type trails concurrently; 
where: 

• n is an integer representing the number of servei- drives 
EDM Backup can use at any one time. 

• media-type indicates the t>'pe of drive. 

For example, if tlie EDM Backup sender has four tape drives, but 
wants to reserve two drives for non-backup puiposes, you 
specif^': 

use at most 2 dlt trails concurrently; 

Changes to this field take effect immediately, altliough no 
backups are terminated to comply with the new limits. 



Limit Throughput To: nnn Per use this field to limit the amount of the network bandwidth 
time available to EDM Backup, thereby allowing the net¥>'ork to 

accommodate applications c:>ther than EDM Backup. With this 
field specified, EDM Backtip monitors its network use. If it 
reaches the specified limit, it does not start another client 
backup until the throughput drops, (However, EDM Backup 
does not .stop any backups currently in process if the 
throughput exceeds this limit.) Specify no limit if you don't 
want EDM Backup to monitor the network. 

Specif}' tliis field in terms of the number of b^nes EDM Backtip 
can use during a specific time period: 

limit throughput to: bytes per time-units; 
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Where: 

• bytes is ihe number of bytes to which you want to limit tlic 
thi-oughput, followed by a unit code (set to 6OOKB pej- 
second at installation). Specify the unit code as follows: 



Unit Code Measure 

k, K, kb. or ICB kilobytes 

m, M, mil, or MB megabytes 

g, G. g\x or GH gigabytes 



lime-units defines the unit of time during which you want 
to limit tlii'oughput to the number of bytes specified: 

Time Code Limits Tliroughput Based on the Specified 
Number of Bytes Per: 

second(s) second 

miniite(s) minute 

liour(s) liour 



You can combine the time tmits, as in this example: 

limit throughput to: 15MB per 1 l-iour 30 

Here are some guidelines: 

if tlie sen-er is connected to a single Ethernet, set this to 
6 (600KB/second). 
- If you have high end clients, tv^'o independent PDDl 
rings, 6 CPU SC-1000, and S DLT drives, you can set 
this for up to 200 t2()MR/second). 

Changes to tliis field take effect immediately. 
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Specifying No Throughput U you want back-ups to proceed as quicldy as possible witli no 

l-inilt restrictions on throughput, specify' no limit (and no other 

opticas). You may want to do this if you have FDD] or multiple 

Ethernets, 

limit throughput to: no limit; 



Maximum Server baokupS.log use this field to specify the maximum size of the backup log file 
File Size (/usr/epoch/EB/log/backups.log) on tlie server (generally in the 

range 16KB-256KB). lliis file provides a record of all backup 
activities, limited only according to the size restriction that is 
specified here. Determining this size is a trade-off l>enA'-een 
using disk space on the servei- versus keeping the backujD 
histoiy for a longer period of time. 

When the file reaches the specified size. EDM Backup Ictcaies 
the oldest data in the file and expires ten percent of that data to 
Iree up space for new information. 

The format of this field is: 

maximum server backups.log file size: file-size; 

Where file-size indicates how large tlie file can get before the 
oldest data is expired. Specif^' tiiis field as a number of bnes 



followed by a unit code (set ti 


0 256KB at installation). Specify 


the unit code as follows: 




Unit Code 


Measure 


k, K, kb, or KB 


Kilobyies 


m, M, mb, or MB 


iMegaliytes 


g, G, gb, or GB 


Gigabytes 



If you want to let the file grow until it is as large as the physical 
storage space allows, specify no limU. By not setting a limit on 
the file, it becomes a permanent record of backup operations; 
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maximurri server backups, log file size: no limit; 

This example sets tlie maximum file size for backups.log to 
200KB: 

maximum server backups.log tile size: 200KB; 

Note: If you do not limit the file size, it may become too 
lai'ge to manage. Also, in HSM systems it is not 
staged. 

Changes to size of the backup log file take effect immediately 



Use this field to specify the maximum size of the restoi'e log file 
(/usr/epoch/EB/'l(3g/' recoveries.log) on the server (set to 256K.B 
at installation). Tliis file provides an audit trail of all restore 
activities, limited only according to the size re,striction specified 
here. It can be used to examine exactly what occui-red during 
restore processing. Determining this size is a trade-off l^etween 
using disk space on the sen'er versus keeping audit trails on the 
serx'er for a longer period of time. 

The foi'mai of this field is: 

maximum server recoveries.log file size: file-size; 
For example: 

maximumi server recoveries.log file size: 200;kB; 

Specify this field exactly as described for the servers backup log 
file. Witli tlte exception of when changes take effect, these two 
settings are handled exactly the same. 

Changes to tlie size of the restore log file take effect the next 
time a restore I'uns. 



Use this field to specify die maxinuim size of the backup log file 
(~ebadmin/cfe«/-;7fl«r(?/backups.]og) on each client {.set to 
64KB at installation). Iliis file provides a brief record of backup 
activities for the client. The format of tliis field is as folkm'S; 



Maximum Server 
recoveries.log File Size 



Maximum Client backups.log 
File Size 
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For example: 

maximum client backups.log file size: 64KB; 

SjDecify lliis field exactly as is described for tlie servei-'s backup 
log file. With the exception of the default and when ciianges 
tiike eiTect, these tvA'o settings are handled exactly the same. 

Changes to this field take effect the next time the corresponding 
client is backed up. 



Maximum Client U.se this field to specify the maximum size of the restcjre log file 

reCOVerieS.log File Size (~ebadmin/67/en/-?7£?;we/recoveries.log) on each client (set to 

64KB at installation), lliis file provides a brief record of restore 
activities for the client, and can be used to locate the moj-e 
comprehensive resio'e information on die sen'cr, 

The format of this field is; 

maximum client recoveries.log file size: file-size; 
For example: 

maximuir. client recoveries.log file size: 32KE; 

Specify tliis field exactly as is described for the servers backup 
log file. With the exception of the default and when changes 
take effect, these tv^^o settings are handled exactly tlie .same. 

Changes to tliis field take effect the next time the corresponding 
client is backed up. 



Catalog ThresllOld to Force THs statement directs catalog processing to schedule a full 

Level 0 Backup (level O) backup (instead of an incremental) for any filesystera 

work item when it detects too many files within that work item 
that have never been backed up. (Applies to filesystem l3ackups 
only, as database backups are always full.) 
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'I'he concern is for files that do not get backed up during an 
incremental backup because the files were added in a manner 
that preserved tlie creation and access time of tlie file prior to 
the last backiip of the work item, hi this case, you want the next 
backup for that work item to be a level 0. Failure to do tliis 
causes catalog processing to take a long time and could result in 
a large number of files not being backed up, meaning they 
could not be reco^'ered. 

Also, see '■'^lien You Change a Work Item or a Filesystem" on 
page B-35 foi' times you should force a level 0 iDackup. 

The format of ilie field is as follows: 

catalog threshold to force level 0 backup: 
threshold; 

For example: 

catalog threshold to force level 0 backup: 10; 

If ebcatcomp detects more than threshold files that ha\'e never 
been backed up for a filesystem work item, it schedules 
(command line scheduling) a level 0 for that work item. If 
threshold is set to zero, the default value, this feature is 
disabled. 

Note: 'lliis .statement can increase the number of level 0 
backups perfomied. 

The following alternate wording for tiiis statement is acceptable 
in the server block: 

maximum files not backed up before forcing full 
backup: value; 

This statement can be overridden by a version of this directive 
tliat can be set within individual filesystem work items. See 
"Maximum Files not Backed Up Before Forcing Full Backu]3" on 
page B-49. 
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Work Group Fields Work groups define a set of work items of the same t)'pe so tiiat 

a template can back them up togetlier (during the same shiit 
and using tlie same trailset) just by referencing tlieir work-group 
name. Specify as many woi-k groups as necessaiy to configuie 
your site. If all your clients can be backed up together by using 
a single trailset, specif)' one work group tliat includes all client 
systems. 

The work -group block looks similar to the following; 
work group: "doc" 

wcrk-item definitions ... 

Note: A work group can be referenced by more than one 
template. Wiiile this may result in liacking up the 
clients in the work group more often than 
necessar\', it does not cause any conllicis (in media, 
Kclieduling, etc.). 

Work items in a %vork group must be of the same type. For 
example, a work group cannot contain file system work items 
with NetWare work items or database wori( items. 

Specify die work-group name as described below, tlien proceed 
to the discussion on coding work items. 



Work Group Name Specif\' the work-group field as any unique 1-63 character name 

used to reference a group of clients, in the following format; 
v/ork group: "work-group name" 

Note: llie work-group name Reld does not end wiili a 
semicolon, l^ut is followed by a bi'ace-delimiied 
block that defines il.s work items. 

Changes to tlie woi-k-group name take effect the next time 
ebbackup processing runs. 
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Fllesystem Each work group is comprised of one oi' more work items. A file 

Work Item Fields system work item defines a set of files to be backed up for a 

single diem, and iiiformation rekuing to iliose files (whetJier to 
back up all the files, resident files only, and so forth). Each 
client requires at least one woi'k item before it can he backed 
up by EDM Backup. 

The following sample shows a work group. Cllie migration, 
ba.seline, and completeness fields are used with HSM.) The local 
work group backs up files on the EDM Backup sei-ver (named 
a das]), and includes three work items: 
« one work item backs up key dautbase files 
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Work item 

used to back up server 
database files 



tsK'o work items back up llie non-database files from each 
of two filesystems {/ and /home). 



KorK group: ' 



a 1 1 a s 1 : LO CAL DATABAS E " 



pec: LOCAL_DATABASE; 
eteness : DB__COMPLETENESS; 
ity: PRIORITY_SERVERDB; 
map: LEVEL_MAP_SERVERDB; 



Work item 

used to back up the 

server's root (/) 

filesystem 



sm: "atlasl:/", "atlasl" 
ec: "/ -xdev"; 

ne filespec 



sd2C/c0t3d0s4"; 
-xdev -staged"; 
-baselined files only; 



Work item 

used to back up the 

server's /home 

filesystem 



filespec: "/home -xdev"; 
migration backup tag: "local_home" 
exclusion taq: " /dev/r sd2C/c0t3d0s4 " ; 
baseline filespec: "/home -xdev -staged"; 

completeness: non-baselined files only; 



Some of Lliese options only apply for a particular type of EDM 
Backup client, as detailed in Table B-2. 



EDM Software Reference 



B-34 



EDM Backup Configuration File 



Table B-2 


Work Item Options Available by Client Type 


Option 




Applicable if the work item is: 


on a 
Migration 
Client 


on a 

Migration 
Client 


Local to the Backup Server 
Level 0-9 Level B1 & B2 


work item: 




yes 




filespec: 


yes 






iMseline filespec: 






— yes 


migration backup tag: 






yes^ — 




yes 




yes yes 






yes 




do not load balance: 


yes 


yes 




















resident files only 


yes-^ 






files nol backed up in migration sto; 


'■e yes'' 






non-baselined files only 






yes'' — 


\eyd map: 


yes 


yes 


yes yes 



1 . Applies wlien baclving up staged files on an EDM Backup sers'er that is also m EDM Migration seiver. 

2. Only used when you reach a project milestone or temporarily decommission EDM Backup, to record the 
filesystems exactly as iliey stand at iliai Lime. 

3. This setting can leave you \'ulnerable unless there's a backujs of the client store. Specifically, il' you don't back up 
a file that's been staged out, but you lose the file's client store on the server before the sei-ver's files are backed up. 
tlie only way you'll be able to restore the file is from an old backup. 

4. Default for this client type. 

Specify each work-item field as described in the following 
discussions. The fields are covered in order as shown in tlie 
syntax above. Repeat die work-item specifications as many 
times as nece.ssary to coiifigure backups for each client. 
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All changes that are made to the work irem take effect tlie next 
time ebbackup pr(xessing runs. 



When You Change a Work Item when you change a work item's file specification significantly 
or a Filesystem (for example, to add a new filesystem to the backup list), 

always schedule the next backup for tliat woit item as level 0, 
and make sure it is backed up rlie next time EDM Backup runs. 
Failure to do tliis causes caudog processing to take a long time 
and may result in a large number of files not being backed up. 

Otiier times to force a level 0 are: 
" When a filesystein covered by a work item changes its 
device number (such as when reformatted or when moved 
to a new system with the same hostname). 
• When you have added files to a filesystem covered by a 
work item in a manner that preserved the creaticjn and 
access time of tlie file prior to the last backup of the work 
item. Sec "Catalog 'R-u-eshold to Force LcN-el 0 Backup" on 
page B-29 and ".Maximum Files not liacked Up Before 
Forcing Full Backup'' on page B-49. 



When You Stop Using a Work if you stop using a work item — for example, after you create 
Item two work items for a client that previously had one — make 

sure to keep the old work item in the configuration file, if you 
delete diat older work item, you lose its association witli its 
client system, resulting in problems when you run history 
reports, 

To avoid this situation, define one work group that contains 
only obsolete work items, and that is not backed up by any 
template. This retains the association between eacli old work 
item and its client, foi- each work item in the group. 



EDM Software Reference 



B-36 



EDM Backup Configuration File 



Work Item Name specify a 1-63 character name thai is unique within the configu- 

ration file. As a conventions, it is good to incorporate the name 
of tlie client when specifying the work-item name, as well as 
some indication of what files are backed up using the work 
item. EDM Backup generates work-item names that look similar 
to the following when eacli client is installed (shown foi" a work 
item that backs up all files on the docl client): 



"docl" 
Work item Name 



Al a mminium. there is ont work item per disk; theic can be 
several work items per client. 

Note: In a HSM system, when defining local-client work 
items, al"s^•avs S]3ecilY one work item to correspond 
to each client sloie that migiaied kj the seixei. b.se 
tliat w-ork item to back up the client store on the 
sen'c'i. Make .sure to include a Backup H.SM lag m 
the work-Item definition, and reference the same lag 
in the corresponding store-name definition. 

A work item can back up an unlimited ntimbcr of files 
IIowcN'er. a work item that backs up more than 2Sf).()0(i files 
will have substitntially slower oitalog processing. 

This example shows die docl client broken down into three 
work items: 
work item: "doclo/", "docl" 
f ilespec: " ... " ; 

} 

work item: "doclo/usr", "docl" 
f Ilespec : " ... " ; 

} 

work item: "doclo/other" , "docl" 

\ 

f ilespec : " ... " ; 
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Client NamS specify the name of the client to which die work item appHes, 

as it appears in tlie autliorized backup list. Always use the 
]:)rimary complete name for the client; not an alias. 



Client Name 



FilespeC to Back Up This field lists each directory, filesystem, and/or file that you 

want to back up using the work item. This field has a 4096 
character limit. 

Specif^' the exact names as they appear in a directory listing by 
using a syntax similar to find. For each directory or filesystem, 
include the name and optional qualifiers. Refer to Appendix I) 
"findxcpio Directives" for more details about the .syntax and the 
semantics of .specifications that this field supports, (.Also see die 
findxcpio man page.) 



Using the Block Form of the Syntax The work-item syntax uses a separate statement (not on tlie 
(Filespec Statement) same line as the work-item name). 

work item: "work-item name", "client name" 

I 

► filespec: "filespec to back up for level 0-9 backups"; 

baseline filespec: "filespec to back up when baselining" ; 

migration backup tag: "migration backup template name"; 

exclusion tag: "tag"; 

priority: priority; 

do not load balance; 

completeness : completeness-code; 

level map: "level map"; 
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Backing Up the Local Client it is important that you back up all filesystems tlial are stored on 

your backup seiver, llie server stores tlie database files for all 
EMC i^ackup and HSM products, as well as tlie bitfiles (client 
stores) \^'ritlen out by EDM Migration. Also, the jjroduci installa- 
tions modify several standard UNIX files, such as /etc/passwd, 
/etc/group, and crontab. 

There is a special ^^deftne maao for use with the local client, 
which causes it to back up all the server's critical database files: 
filespec: LOCAL_DATRBASE; 

The following macro is included in the autoconfigui'ed work 
item for tlie server's database files (shown below for the atlas! 
sender), and should not be changed: 
v/oik item: "atlasl :LOCAL_DATABASE", "atlasl" 

{ 

filespec; LOCAL_DATABASE; 
completeness : DB_COI>'iPLETEigESS ; 
priority: PRIORITY^SERVERDB; 
level map: LEVEL_KjAP_SERVERDB; 



Baseline Filespec The baseline filespec is available if you purchased HSM, and 

applies when you back up the EDM Backup sen-er's ov.'n files 
— generally only the files that are used for stageable 
filesystems. It lists each filesystem for which you want to 
maintain a baseline backup (level Bl, B2, or both), in this 
foimat: 

baseline filespec: "filespec to back up when baselining"; 

If you want to maintain a baseline backup for ,/liome, you 
specify: 

baseline filespec: "/home -xdev -staged"; 



Migration Backup Tag include a migration backup tag for use with level 0-9 backups 

on a local client, when: 
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1. The EDM Backup server is also an EDM Migration server 
and 

2. The files that are being backed up are the staged (migrated) 
versions of client files 

A migration backup tag is required in tliis case. Specify one 
work item for each client store, and include this field: 

migration backup tag: "raigratdon backup template 
name" ; 

Where migration backup template name is a 1-63 character 
identifier. The first l6 characters must be unique across all work 
items that bacl< up tije server's own files, and must inatch 
exactly the migration backup template name that is specified in 
the definition of die migration store used to stage the same files 
from their network client. 



Migration Backup Tag 



Network Client 
Stores 



Client B store-name Definition 
Specifies this Migration Backup 
Tag Name: 




Work Item used to Back Up the 
Client B Store Specifies this Backup Tag: 



migration backup tag: 



'I'he migi'ation backup tag is used to update the backupdates 
database (/'usr/epoch./etc/backupdates), so that a subsequent 
backup of a network client that is migrated to this server can 
deteimine whether the staged-out client files were already 
backed up on their migration sen'er (tliat is, the servei' wliere 
you define the work item). 
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Exclusion Tag use this field to idenlity any work item that slioiild noi be 

backed up concurrently with one or moi-e other work items. For 
each client, specify the same tag value (1-63 characters) for all 
those work items that are mutually exclush'e. using this format: 

The combination of the exclusion tag and client name forms a 
unique identifier within the configuration file, but y<ju can use 
the same tag value for any number of clients. 

TyiDically, you use an exclusion tag for w-ork items that back up 
data stored on the same physical disk, to prevent disk tlvashing 
dining backup processing (shown below lor nvo work items 
that back up files from the rsd2C/c{Jt3dOs4 device): 
work item: "atlasl:/", "atlasl", 
\ 

filespec: "/ -xdev"; 

exclusion tag: "/dev/rsd2C/c0t3ci0s4" ; 

work item: "atlasl : /home" , "atlasl", 

{ 

filespec: "/home -xdev"; 

exclusion tag: " /dev/rsd2C/c0t3d0s4 " ; 



If no exclusion tag is included for a work item, ebbackup 
assumes it can process that work item concurrently with any 
other work item. 



Connection Via You can In.stall just one copy of die I'DM client software on 

UNIX client machines that are equipped with more tlian one 
Ethernet, I'DDl, Token-Ring, or A'l'M port and use it to have 
your backups obtain higher tlu-oughput rates by taking 
advantage of the multiple network ports. 
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Setting up the Network if possible, at least one of the network cards foi- tlie EDM and 

the clients should be connected to a separate network 
dedicated to backups. This reduces the amount of network 
traffic on the customers' main network and i-educes tlie impact 
of backups on tlie users. 

The EDM should be configured on the netwoi-k in a way that 
each card uses a single/different client port, 'lhat is. card "A" on 
the sen-er should talk to "A" on die client and card "B" on ilie 
server should talk to "B" on the client. Each client port must 
have a distinct clienlname. For example: clientname_A. 



Configuring tiie Work Items You can configure the client's backups to be divided into 

separate backup streams (each defined by a "work item"). You 
can specif^' (in the work item) an alternative pon name for one 
or more of the backup streams. The clienlname is used as the 
name of tlie default port for backups. (It can match or differ 
from the hostname of the client machine.) 

To set up a filesystem work item with an alternate network port, 
add the distinct clientname to the EDM Backup Configuration 
window: select Work Item Options and enter it in the Generic tab. To 
set up online database backups, use the Configure Online Options in 
the Client tab. 

This puts the clientname in a connection via parameter in the 
work item statement in eb.cfg. which specifies it as tlie alternate 
port name. 



Priority Use this field to assign a priority' to the work item, forcing it to 

run either before or after one or more other work items. 

Wlien you start a backup, ebbackup searches through its 
schedule for the work items that have the highest (that is. 
lowest-numbered) priority. It makes that p]-iority current, and 
processes all work itt^ns that have that cun-ent priority to 
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completion, 'llien it searclies Jbr the next lower pilority and 
makes it cun-ent, and so fonh. until all work items are 
]■) recessed. 

Note: The use of priorities limits the flexibilin- that is 

avaikiblc to EDM Backup in clioosing what lockups 
to run next, and migiit reduce the efficiency willr 
which the server's resources are used. 

]f a work item is added to tlie schedule and has a priority that's 
higher (i.e., numerically lower) dian tlie one being processed, 
that Vs'ork item is started as soon as sei'ver resources are 
available, and its prioiity becomes the current priority. This 
might be the case, for example, if a request is submitted online, 
or cron starts a scheduled backup wliile another backup is still 
running. 

Use tills syntax to specify the priority: 

priority: priority; 

Where priority takes one of mo forms: 
» assigned integer in the range -25 to 50. where -25 specifies 
the highest priority (ain first) and 50 specifies the lowest 
priority (run last). 
• one of die following ?=^define macros: 



Table B-3 




Priority Settings 


Macro 




Equivalent Description 


i^RlORI'lY. 


.Fli^ST 


-25 Bacl<up.s should run before the general backups. 


PRiORny, 


.DEFAULT 


0 Backups should be considered pun of the genei-al bacicups I no 

special priority). I'his is the Initial setting at installation, except for 
the woriv item used to back up die sers'er's database files. 


PRlORriT. 


,LAST 


25 Backups should n.in after the general backups. 


PRIORI'IT. 


3ERVERDB 


50 iiackups should run last. 'Ihis keyword is ]-eser\'ed for use in Ijacking 
up the seivei-'s database files (f,6CALj:)ATABASE). 
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If die backup server is also an HSM sen-er, EDM Backup 
auiomalically backs up the stores For each migration client 
before backing up the client files. You do not have to be 
cc^ncerned \\'i\h setting a higher priority for the local-client work 
items in this case. That way, if tlie level 0-9 backup of a 
networked migi^ation client calls for a backup of migrated file, 
and the work item specifies a completeness option o{ files not 
backed up in migraiion store, the file do not have to be copied 
back in and backed up again. 

To ensure that tire migration stores are backed up first ft^r each 
migration client, you must: 
T Use the same prifM'iry-' for die network cHent and all work 
items tiiat back up tlie client stoi'es on the server (genei^ally 
priority 0, the default). 
2, Set the migration tags correctly tor all work items that back 
up tlie client stores on the server. 

Note. E ^ou puichased HSM (^\idi hasLlinmg) and the 
template specifics do all baseline baiknps Ixjau 
iioniial backups the bdselme backups alx\a^s nin 
before am lc%el 0 9 backups loi that leniplaie, 
legaidless ol the pnc)nt> ioi an\ speufit work item. 



Load balancing works in conjunction with automatic sched- 
uling, and is ilie method whereby EDM Backup schedules 
backups as evenly as possible across all clients. By default, EDM 
Backup assumes diat each work item participates in load 
balancing, which can result in some work items having more 
than one level 0 backup during any given rotation. 

Include tlie following statement if you do not want die work 
item to participate in load balancing: 

do not load balance; 
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'lliis ensures that tlie work item does not receive more level 0 
backups during the rotation period than are called for. This 
might be useful, for example, for filesystems tliai lake a long 
time to back up, or for production sy.stems whose resource 
consumption is critical. 



lise this option for files under migration control, to avoid 
performing duplicate backups of the same file data; 

Note: You can u.sc a special *define completeness macro, 
DB_COMPLETENESS, with the local client. This 
macro equates to all files. It is included in ihe 
autoconfigured work item for Epoch's database files 
and should not be changed. 

Use this option for files under migration control, to avoid 
performing unnecessary backup. It limits the files for which the 
data portion- is written to the backup. (Remembei- tliat the 
extended inode is included for each file scanned, regardless of 
whediei- its data is written out.) 
completeness : completeness-code; 
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Specify the completeness-code as any of the \'alues below. Tliis 
field applies for level 0-9 backups. Ilie initial setting varies 
depending on the type of file that i.s being backed up (as noted 
in Table B-4). Generally it is a good idea to use the defaults. 



Description 



Completeness Settings in HSM Systems 
Applicable For 



Back up tilt data portion of all fiks 
filespet I Lgai dk ss of w lu-ie the\ il 
and wliLthei the\ it bast'lmed 



Residtni file- 



All clients tthis is the onlv 
option available for backup 
clients 
Migiat 

lext'K 



Non-mi grarior 
clienls S. st'iNt 
ilsolDM database files 



1 clients) 



Back up the data portion lor onlv those file.' 
that aie lesulem (lota! to) the client oi, loi 
the stnti that aie stoietl on the ma,i,netic 
disk. 



]i a hie has Ix-cn staged oiiK back up the IDM Migration clients 



on the backup 
server (i.e., tJie kjcal client) 
and IDM Migiation clients 



backed up in data j^ortion ol the hie il it 
migration store hasn x been backed up 



n tht HSM senei 



Non-baselined Back up the data portion for onlv those files 
files onl\ that aien't bastlintd doi ust altti a baseline i' 

taken) I his option is onh a\ailabk il \ou\e 

purcha.sed H.S.M. 



Local (seiver) ckent (but r 
senei's database files) 



IDM Migia 
ehents 



Local client 
(c\ttpt sen ei s 
database files) 



1 II s salesi to use the ne\l nphiin (file-- inn backeci up in migralion sloit) wilh EDM Migration nelwoik tiienf- (and 
non-basehned files onh kii ilu loial TDW Migintion ciitnt) Tlie resident flics onl^ scOinp can lease \au \ulntia|->lc 
unless there s a backup ol ihc dicnl store. Specificallv. il voii don t back up a file ihai s been siagcd nul bui vou 
Inse the hic s tlitnl sunt on the sluci Ixlure Uic senei s files aie backed up Uic tmh \\a\ sou 11 he able lo resioit 
the file Ls from an old backup. 



L6V6I Map Use this option to override the loackup level(s) that normally 

occur for the work item, based on the template that is used. 
This feature is useful when a few work items need a level of 
backup tliat is different from tnost of the work items referenced 
by a template, and saves having to define a separate template 
for diosc work items. 
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The level that a level map specifies completely replaces (in the 
.schedule) the le\'e] that is otherwise peiformed. EDM Backup 
does not keep a record of the old (replaced) level. 

Note: The level map applies for custom and auiomatic 

scheduling. Command-line scheduling does not use 
the level map. 

Specif)' the level map by using one of the ^define macros that 
are listed in the following talile. for example: 
level map: LEVELJ'4A.P_SKIP_ALL_BUT_^L0; 



Table B-5 


Level Map Settings 




Level Map #clefine Macro 


Equivalent Value 


Description 


LE VEL_MA1^_.SK 1 P_ALL_BU'I _l ,0 


'TiBOxxxxxxxxx" 


Only run level-0 and baseline backups. Skip all 
oilier levels. 


lEVEl.^MAPJWHRYri llN(T„lS„li) 


"RliOOOOOOOOOO" 


Run all scheduled backups as level-0, regardle.ss 
of the level specified by the template. 


!Ji:VEL_MAP_SKIP_ALl. 




Skip the work item completely. Don't run any 
backups, 


LEVlil_MAP^SERYERDB ^ 


"BBOOOOOOOOOO" 


Same as LEVEL31AP_EVERYnilNGJS^L0, but 
reser\'ed for when backing up the EDM Backup 
sen'er's database files. 



1. Tlic LOC:aL- DATABASE work item {for EDM Backup databa.se file.'.) must always receive a level 0 backup, using ih 
n^1-t._.MAP_SERVT.I!DB level map. This .simpliRe.s restoring those critical tiles. 



Alternatively, spedf>? any 12-character siring you want, where 
each character is indexed to a bacMip level (B1, B2, "BB" then 
0-9, in that order). Use an x to suppress a level of backup 
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completely. Any other value refers to the le\'el of backup that 
should occur when the work item is processed at the indexed 



Work item is backed up at level 5. 1 

The following string requests that each backup proceed at the 
normally scheduled level, and indicates that there is only one 
baseline backup: 

level map: "Bx0123456789"; 

'I'hough you cannot remap a baseline backup to a different 
level, you can cause it to be ignored. If the rrailsel requests a Rl 
backup, for example, you cannot change it from tlie first id 
(level map: "BxOh..") to tlie second id (level map: "xB(J]..."), but 
you can suppress it entirely: 
level map: "xx0123456789" ; 

Hei-e are some examples of level mapping; 

• To cliitnge level 6-9 backups to a lex-el 5 lor the vv'ork item: 
level map: "BB0123455555" ; 

• For stable filesystems that seldom change, iiin the baseline 
and level-0 backups as scheduled, but ignore other levels; 
level map: "BBOxxxxxxxxx" ; 

« For filesystems diat change frequently but for whicli incre- 
mental backups are not used during restore (as for the EDM 
Backup diilabases), ixin all backups as level 0; 
level map: "BBOOOOOOOOOO" ; 



level. 



Template requests a Level 9 Backup. 

(Level 9 indexes to the Last Position in the map.) 




level map: "BB0xxxx5e785" ; 
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If yoii are running level 9 backups manually during ilic day 
(in additi(3n to the automatically scheduled nightly 
backups), you might map the nightly level 9 backups to 
level 5, then specify a separate trail (set of media) for die 
levels 5 and 9. 'I'he trail that is used to restore files do not 
involve the manually run level 9 incrementals that are taken 
throughout the day: 

Because the level map is not used when you run command- 
line backups, the level 9 incrementals that are run from the 
command line actually perform level 9 backups. 
If you want to suppress all backups: 



Access Time Preservation Two alternative statements are available for clients that do not 

allow invisible file access. 

(With invisible file access; neither alime nor ctime is updated 
when files are backed up. Clients that support invisible file 
access: Solaris 2.1 or higher for SPARC, SunOS -1.1.3 for SPARC, 
Tills setting does not apply to tliese clients.) 

For all other clients, you can decide whether each night's 
backup process itself either: 

• presences the original change time (ctime), but updates 
each file's access lime (atime) to the time of die backup, or 

• prcseives the original access time (atime), Ixit updates each 
file's change time (ctime) to the time of the backup 

*l'o preserve the original ctime, use 

preserve file change time during backup; 

To preserve the original atime, use 

reset file access time after reading file; 
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Note; With "reset file access time after 

reading file;" incremenia! backups do not 
clicck die ctime For changes as iliey do wiih 

backup;". The result; For applicable plalforms, if 
you perform funclions thai change ihe inode, such 
as chmod, these changes are not recorded during 
incremental backups. 

These two options are mutually exckisive. (If botli are applied, 
a semantic warning is issued during backup processing and 
tlien die system's default operation — presening ctime but 
updating atime ■ — is performed.) 



Maximum Files not Backed Up This .statement directs catalog proces.sing to schedule a full 
Before Forcing Full Backup (level O) backup (iasteacl of an incremental) for this filesystem 
work item when it detects too many files within this work item 
that ha^'e never been backed up. (Applies to files>'stem backups 
only, as database backups are always full.) 

The concei'n is for files that do not get laacked up during an 
incremental backup because tlie files were added in a manner 
that p]-eserved the creation and access lime of the file prioi- to 
die last backup of the work item. In this case, you want the next 
backup for that work item to be a level 0. Failure to do this 
causes catalog processing to take a long time and could result in 
a large number of files not being backed up, meajiing they 
could not be recovered. 

Also, see '"Wlien You Change a Work Item or a Filesystem" on 
page B-35 for times you should force a level 0 backup. 

The format of the field is as follows: 

maximum files not backed up before forcing full 
backup: value; 

For example; 

maximum files not backed up before forcing full 
backup: 10; 
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If ebcatcomp detects more than falue files iJiat have never 
been backed up for tliis fi]es)'Stem work item, it schedules 
(command line scheduling) a level 0 for this work item. If I'ahie 
is set to zero, tlie default value, tliis feature is disabled. 

Note: lliis stalemcni can increase the numlier of level 0 
backups perfonned. 

This statement overrides a version of tliis directive tliat can be 
set in the server block, which applies to any filcsystem work 
item. See "Catalog llireshold to Force Level 0 Backup" on page 
B-29. 



Database Note: 'lliese '\Database Work Itcm,s" pertain to the so- 

Work ftSm Fields called "offUne database backup" functionality 

supported prior to EDM 44.0 and are inckided here 
to support restores only, lliese work item sjDecifica- 
tioTO do not apply to llie various database backup 
clients tliat arc currently supported for backu]^. 

Support for new backups u.sing the "ofiline database backup" 
functionality.' are not supported as of EDM 4.4.0. Nor does EDM 
'i.-i.O .support any reconfiguration ofthe.se databa,se work items 
or configuration of new ones. 

However, support for restore of backups taken using the 
"oftline database backup" functionality continues in IiDM 4.4.0, 
and to be alile to restore such a backup depends on the 
continued presence of its paiticular database work item in your 
eb.cfg. Hence this section continues to be included in this 
revision of the EDM Sojtware Reference manual. 

Note: The work items that pertain lo the various database 
clients are documented in the individual database 
client guides as appropriate; they are not included 
in this appendix. 



EDM Software Reference 



B-51 



Database V\tork Item Fields 



A database work item defines a set of databases to be backed 
up. The following is an example, 

work item: "chipmunk ;raaster+ : Sybase" , "chipmunk" 



filespec: "!X;_FILE___L1ST /ext_ibm/sybase/master . dat"; 

database type: "sybase"; 

database server: "SYBCKIP"; 

database name: "master model tempdb"; 

inclusion tag: "chipmunk : SYBCHIP" ; 

type: coordinated; 

backup client initialization corrimand : "-exec^as 
'Sybase' -DEServer 'SYBCHIP' ebcv_shutdown 
Sybase" ; 

backup client cleanup corrLmand: "-6;.:ec_as 'sybase' 

DBServer 'SYBCHIP' ebcv_startup sybase"; 
use connection method: netware@514; 

In the discussions that follow, the fields are covered in order as 
shown in the example above. The work Hem specifications are 
repeated as many times as necessary to configure backups for 
each client. 

CAUTION: These database work items must remain as 
they are for restores of their corresponding 
backups to work. 



Database Work Item Name The database work item name thai is generated during auto^ 

discovery is of tlie format database_name\+\:database_type\:n]. 
If multiple databases were backed up in a work item, tlien 
databasejiiame represents one of the database names (chosen 
arbitrarily), and a plus sign (+) is appended to the name. 
database_type is one of oracle, informix, or sybase. 

Because a database work item name must be unique, an integer 
was appended if necessary to make it unique. 
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Client Name 



Tliis is name of the client to whicli the work item applies, as it 
a]3pears in the authorized backup list, ,'\]%\'ays use the primary 
complete name for the client; not an alias. 



Filespec 



The DO_F]LE_LIST in this field specifies a file on the client that 
lists each file associated with the database that was found 
during database auio-di,scovery. This field has no character 



filespec:"DOjqLIUJST 



Jbm/sybai 



Partition Spec 



The DO_PART_LIST specifies a file on the client that lists each 
raw partition associated with the datatiase tliat was found 
during database auto-discovery. 



Database Type 



This .syntax .specifies the database type: 

databa.se type: "database_t}pe '\ 

Database type is one of: informix, oracle, sybat 



Database Server 



This field sets the name of tlie database server for the work 
item. 'Hie syntax is: 

database server: ''database_sewer_name"; 



Database Name 



This field contains one oi' more database names, separated by 
spaces. 
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Type For a database work item, this field must be as follows: 

rype: coordinated; 



Exclusion Tag This field ideniifies any work item that should not be backed up 

concurrently with one oj- more other work items. Vor each 
client, the same tag value (1-63 characters) is specified for all 
those work items that are mutually exclusive, using this format; 

For more information, see "Exclusion Tag" on page B-40. 



Inclusion Tag a single database might backed up by two work items: one 

for the raw partition, and another for the files. The inclusion tag 
is used to cooitlinate back u]3 of work items that refer to the 
same database. By default die inclusion tag value is the work 
item name. The syntax is: 

inclusion tag: "inchisionjag"; 



Access Time Preservation Iv^-o alternative statements are available for clients that do nor 

allow invisible file access. 

(With invisible file access; neither atime nor ctimc is updated 
when files are backed up. Clients that support invisible file 
access: Solaris 2.1 or higher for SPARC, SunOS 4.1 .3 for SPARC. 
This setting does not apply to tliese clienLs.) 

For all other clients, you can decide whetlier each night's 
backup process itself either: 
• presen'es the original change time (ctime), but updates 

each file's access time (atime) to the time of the backup, or 
» presej-ves the original access time (atime), but updates each 
file's change time (ctime) to the lime of the backup 
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To preserve die original clime, use: 

preserve file change times during backup; 

'I^o presei-ve tlie oi'iginal atime, use; 

reset fi.le access time after reading file; 

These rwo options are murually exclusive. (If l^otli are applied, 
a semaniic warning is issued during backup processing and 
tlien the system's default operation — preserving ctime but 
updating atime — is performed. 



Priority This field assigns a priority to the work item, i'orcing it to run 

either before or alter one or more other work items. See 
''I^riority'' on page B-4] for more information. 



Do Not Load Balance Load balancing schedules backups as evenly as possible acros.s 

all clients. Tlie following statement excludes the work item irom 
load balancing: 
do not load balance; 

Fo]" more information, see the discussion under Rle System 
Work Item Fields, "Do Nor Load Balance" on page B-43. 



Backup Client Initialization This is the ebcv_shutdown command that is run on the 
Command database client before shutdown. 

The command parameters are 

-DBServer servername \ 

-DBA database_administrator_name \ 

-DBAIdent encrypted_dba_password \ 

database_type 

Do not attempt to edit the encrypted password. 
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Initialization Timeout This field specifies the amount of time to wait before the 

shutdown and backup are considered to have failed and the 
attempt is terminated, 'Hie syntax is: 

backup client initialization timeout: n day n hour n minute n second; 



Backup Client Cleanup This is tlie ebcv_startup command that is run on the database 

Command client before restarting the database. 

The command parameters are: 

-exec_as usemanw \ 

-DBServer seivername \ 

-DBA ck4tabase_administrator_n(nne \ 

-DBAldenl enciypted_dbaJ)assword \ 

database_t)pe 

Do not attempt to edit the encrypted password. 



Cleanup Timeout Amount of time to wait before the restart is considered to have 

failed and is terminated. Note that this has no effect on the 
actual backup, 'llie syntax is: 

backup client cleanup timeout: n day n hour n minute n 
second; 



Buffer Sizes The buffer sizes for the server and clients can be tuned for 

better backup and restore performance, llie buffer sizes you 
choose depend on your site's configviration. Factors that 
influence the optimum buffer size settings are: the numl:>e]- and 
type of libran' units and RAM in the backup server. 

The syntax of the buffer size fields is: 
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backup client data biilTer size: n N'lB; 
backup server data buffer size; n MB; 
recoveiy client data buffer size: ;z MB; 
recoven' server data buffer size: )/ MB; 



Backup Start Time This field specifies an additional qualification to the start time 

for nightly processing, which is specified in a croniab entry. The 
default crontab start of nightly processing is 11:00 p.m. 



Level Map This option overrides tlie backup level(s) that would normally 

occur for die work item, based on the template used. 

For more information, see "Specify the completeness-code as 
any of the values telow. This field applies for level 0-9 
l^ackups. Tlie initial setting varies depending on the t\'pe of file 
that is teing backed up (as noted in 1 able B-^l). Generally it is a 
good idea to use the defaults." on page B-45. 



PC Work Item Fields These fields are used for all PC clients: NetWare. OS2, and 

Windows NT Backup Clients and for OpenVMS Backup Clients, 
hi several cases the word netvA'are is embedded in die code, but 
the field is used for all PC clients. 

Note: For details, sec the appropriate client manual. 
The following is a sample Windows NT woi-k item, 

work iterr,: "prince : /C/" , "prince" 
{ 

filespec: "DO^FS /C/"; 
exclusion tag: "PRTNCE_HarddiskO" ; 
use connection method: netware@3895; 
netv^are username: "supervisor"; 
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Note: The •■DO_FS^' direciix'C is not valid for Net War 

OS/2. 



Work item Name 



This field defines the files to be backed up Ironi a single client's 
resource. For exam]D!e, the default syntax ibr Windcjws NT is: 



semeTnaine is tlie name of the PC server, resouro 
directory, or volume to be backed up. 



Connection Method 



11ie connection method defines the TCP./IP port oji which tlie 
client is listening for a ccjmmand from the backup seiver. The 
syntax is: 



use connection metliod: netvvare 
where minn is the port numlier, 



NetWare default 
OS/2 default 
Windows NT default 
OpenVMS default 
N'i- SQL Server 



netware® 1776 
neTVv'are@1492 
netware@3895 
netware® 3896 
netware® 5600 



It must be the same as the port numlier that is set on the 

PC server. If you change one, you must change tliem botli and 

rerun the configuration on tlie PC server. 



Filespec 



File specification describes the files to be backed up on the 
client. 
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Netware Username Hie nem are issemame entry deiermines whar PC user privilege 

can execute backups and restores. For detailed inibrmation on 
how this works for individual clients, see the appropiiate client 
manual. 



Netware Encrypted Password The ncnvare enciypted password entry provides the required 
password to the PC user who can execute baclcups and restores. 
Do not attempt to edit it directly. Make any changes through the 
EDM Backup Configuration window. 



Netware Client TSA The netware client TSA entry assigns a target ser\'ice agent to 

the PC server. 

In NetXX'are, OS/2, and Windows NT tlie foraiat is: 
servername . filesystem 



Netware Client Target The netware client target defines a PC client as a target in need 

of service. 



Exclusion Tag The excltusion lag ensures single-tlireaded processing for tlte 

client. All work items with the same exclusion tag execute 
sequentially. Backup processes proceed one at a time. 



BSCkUP TrdilSetS a backup media set (trailset) defines all of the trails that are 

used for one or more work groups, (including the type of media 
to which the backups should be written for each level). It 
defines the retention period for the backed up data and related 
catalogs and saveset records. It also defines the level at which 
yoti want to compress the catalogs (to save disk .space). 
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When running ebbackup, you identify the schedule tejnplaie to 
use. Tliai template references to other types of configuration 
constructs: 

• one or more work groups 

• the irailselCs) thai you want lo use to back up those work 
groups 

Each template requires one trailser (called the phmaiy trailsef), 
and can include a second (ahernate) trailsei. Generally the 
altej-nate irailset is used for off-site storage. 

The backup trailset is similar to the following (for simplicity, 
only information for levels 0 and 9 are used): 

backup trailset: "on site 1" 

{ 

use trail: "fulls-tape", dlt for level 0, 
using at most 8 clients concurrently; 

duplicate media after backup on 1 copy, 

appending to current media copy; 
use trail: "incr-dlt", dlt for level 1-9, 
using at most 8 clients concurrently; 
use trail: "baselines", EO for level Bl, 
using at most 8 clients concurrently; 
use level Bl for baseline backups; 
keep backups of level 0 for: 1 year; 
keep backups of level 9 for: 3 months; 

keep duplicates of level 0 for: 1 year; 

keep duplicates of level 9 for: 3 months; 

keep backup catalogs of level 0 for: 1 year; 

keep backup catalogs of level 9 for: 3 months; 

keep saveset records of level 0 for: 1 year; 

Note: Duplicate media information (as shown in lines 5, 6, 
14, and 15 of the above example) appears only if 
media duplication is configured. If new media is 
requested for duplication, the line "using new media 
at each duplication" appears in place of line 6. If 
manual duplication is enabled, the line "manual 
activation of media duplication" appears after line 6. 
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Specify as many media sets (tj-ailsets) as necessary to configure 
your site: one for each unique coml^ination oi^ backup levels, 
media, and length of time to keep the backup data, catiilogs, 
and saveset records. 

Note: 'Ilie fewer backup schedule templates, trailscis, and 
trails you use to configure your site, the fewer 
backup volumes EDM Backup needs to access 
during processing. 

13eflne each field as described in the sections thai follow. 



Backup Trailset Name use this field to .specify a 1-63 characta- name for the B-ailset 

(defaults ioprwiaiy at installation). This name must be unique 
within the configuration file; 

Note: Tlie trailset name field does not end with a 

semicolon, but instead is followed by a brace- 
delimited block tliat defines its trails. 

Changes to the trailset name lake effect the nexi time 
ebbackup processing runs. 



Use Trail Li.se this field to specifs' the traU, including the name for the 

collectio]! of media designated by the U'ail, die type of media 
that is used, the level of backups written to the trail, and the 
maximum number of clients that can be backed up concurrently 
to iliis trail (vs. the maximum number of clients that can be 
backed up concurrently lor tlie endre server, and specified l^y 
u.sing the global maximum simultaneous clients field in tlie 
server block). 

You can have up to 12 trails per trailset — one foi' each backup 
level (0-9, R1 , and B2). Each baseline level rcc]uires its own 
trail, bevels 0-9 can share trails. You generally want one or tvv'o 
u-ails for levels 0-9, plus die baseline tralKs). 
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This field can lake two forms, and includes four fields: ihe trail 
name, media Vfpe, baclaip level, and numbcj- of concurrent 
clients. Each field is described following the syntax below: 
use trail: " trailname" , media-type for level n, 
using any number of clients concurrently; 

or 

use trail; "trail name", media-type for level n, 
using at most n clients concurrently; 

Changes lo the tise trail portion of the field take effect the next 
time ebbackup processing runs. Changes to the using . . . clienls 
concurrently portion take effect immediately. 

Specif\' the trai] name as 1-11 characters. Trail names arc used 
in volume management as part of the volume label name. For 
levels 0-9, the trailname and the media r>'pe are combined to 
form the label name. For baselines, the trail name is the etitire 
label name. 

Note: Hie more trails you use for each set of work groups 
that are backed up together, the more overliead 
you'll incur in terms of media management and 
tracking. 

Specify the type of media to which the trail is written. 

Specif\' the level(s) of backup you want to write to tills trail, 
using one of three formats: 

• A single level (0 through 9, Bl, or B2); 

use trail: "trail__l", dlt for level 9, ... 

• A range of levels: 

use trail: "trail_l", dlt for levels 0-9 ... 

• A compound (AND) statement that includes two levels, or 
ranges of levels: 
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use trail: "trail__l", dlt for levels 5 and 
levels 8-9 ... 

Only use level Bl or B2 if you purchased HSM to indicate 
whctlicr you want to maintain a level B] or B2 backup. If you 
want to maintain iavo baseline levels, specify one trail as Bl and 
the other as B2. 

Note: Never write level B] and B2 backups to the same 
trail. 

If you identify more tlian one trail for a particular level, the last 
specification overrides the others. In the following example, 
EDM Backup uses the incr-dlt mil for level 9 and mid-dll for 
level 5, even tliough levels 9 and 5 w-ere included in the range 
of levels specified for tlie (firsO fidls-tape trail: 
use trail: "fulls-tape", dlt for levels 0-9, 

use trail: "incr-dlt", dlt for level 9, 

use trail: "mid-dlt", dlt for level's, 
using any number of clients concurrently; 

Make sure to include every level of backup you want to run in 
at least one trail. For example, if you want to perform level-3 
backups from the command line, you must define level 5 
somewhere in the trailset. It is best always to include a range of 
levels (for example, 0 through 9) for cacli trail, even though 
some levels may never be ased. (Autcjmatically .scheduled 
backups only use levels 0 and 9, for example.) 



Maximum Number of Concurrent Specify the maximum number of work items (not clients) that 
Clients can be backed up at the same time to tliis trail, in the range 1-24 

(defaults to 8 at installation): 
using at most n clients coRcurrently; 

Alternatively, specify as many work items as possible (up to the 
number Indic^ated by the seiver block's maximum simultaneous 
clients field): 

using any number of clients concurrently; 
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The recommended selling is from 2 to 8: 
' Use a lower number (for example, 2-3) if the trail is used 
mostly for full backups, or I'or incremenials that include a 
lot of file data (vs. extended inodes only) 

• Use a higher numbei- (up to 8) if the trail is used mostly i'or 
sparse incremental backups 

• Choose a value in between if the ti'ail is used for some 
combination of full backups and sparse incremental 
backups 

This setting is used in conjunction with the .system-wide (servei' 
block) maximum simultaneous clients field, to control the use 
of system resources. Regardless of the trail-level setting, there 
will never be more work items processed concurrently than are 
specified by the system-wide value. 

For example, if you are using two trails that each specify four 
work items but your .system-wide work-item limit is six, thei-c 
can never be more than six work items writing to the two trails 
combined, at any one time, hi this situation, EDM Backup: 

• Starts backups on four work items using the fii'sl trail. 

• .Starts backups on two more work items using the second 
trail, bringing tlie total number of work items processed loy 
the server to the limit. 

• Starts a new work item each time an active work items 
finishes, keeping the total number of work items to six. In 
juggling the work items, EDM Backup does its best to allot 
equal resources to all scheduled work items. 

This example is illustrated in Figure B-2 (where, for simplicity, 
assume one work item per client). 
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1-2 Backup Processing 

EDM Backup starts six work- When a work item finishes {1), As eacli work item finislies (3), 

items — 4 use the 1st trail, 2 EDIVI Backup starts a new work EDIW Backup starts a new one (4). 

use the 2nd. item (2). 



^ (5) Backup Completes " 



'" '' 0 Backup Completes 



] start a New Work Item 



1st Trail 



&e 

|l l| Active Backups 0 Start a New Work Item 

IBH Completed Backups 



Use Level B1 1 B2For Baseline if you are using automatic scheduling, the scheduler writes a 

Backups baseline backup to a Bl level trail. If an alternate trailset is 

configured with a 132 level ti-ail, tlie autoscheduler writes an 
alternate night baseline backup to a B2 level trail. 

Note: The emr>- "use level Bl for baseline 
backups; " in die eb.cfg file is ignored by the 
backup scheduler. The B2 level is always used for 
baselines on alternate night as long as the alternate 
traiisel is configured with a B2 baseline trail. 
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Specify at most one baseline level per trailsel. If you include this 
field, make sure to specify a use trail statement for the baseline 
backup. 

Omit this field if you are not writing baseline backups to tlie 
trailset, or if you plan to request all baseline liackups via custom 
or command-line scheduling. This field is ignored with custom 
and command-line scheduling. 

Clianges to tliis field lake effect the next time EDM Backup 
schedules work items. 



Use this field to indicate liow long to retain the backup data 
before reusing the backup media. Specify tliis field by using the 
follow'ing format, repeating it as many times as necessaiy lo 
configure expirations for your site: 

Note: ]f you identify more than one trail for a parlicular 
level, the lasi specification overrides the others, 
keep backups of level n for: time-period; 

where: 

• n specifics the backup level (s) to which tlie setting applies 
(0-9), by using one of three formats as descrilied for the use 
trail statement (a single level, fange of levels, or compound 
statement that combines levels). 

Generally you define the same levels (or set of levels) here 
as are specified via use trail statements for the same trailset. 

Note: This specification does not apply for baseline 
bacltups. 
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« time-period defines the amount of lime to retain the 

backups for this level, specified as an integer followed by 
an appj-opriate ^lnits value. 

Units 

secondts) 
dayts) 
week(s) 
month (s) 
year(s) 

foj-ever (do not include an integer) 



You c^n expire backups immecUateh't 

keep backups of level 2 for: 1 second; 

Or keep tliem indefinitely: 

keep backups of level 0 for: forever; 

Y'ou can combine the time units, as in the following example: 
keep backups of level 9 for: 1 year; 6 months; 

Always expire backup data before (or at the same time as) the 
con-esponding saveset records, but after (or at die same time as.) 
the con-esponding analogs. An exception occurs if you specify 
l?eep backups forever, in which case you can expire tlie saveset 
record without expiritig the media. Make sure to cover even- 
backup level tliat is used. 

The recommended setting (and the initial value at installation) is 
] year for level-0 backups, and 3 moi-iths foi- levels 1-9: 
keep backups of levels 0-9 for: 3 months; 
keep backups of level 0 for: 1 year; 

Note: If you identify more than one expiration for a 

particular level, the last specification overrides the 
others. 



EDM Software Reference 



Backup Trailsets 

If you omit tliis field, it defaults to forei>er. 

Changes to tliis field take effect immediately, but do not affect 
any curi-ently running work items. 



Use this field to indicate how long to retain a duplicate of 
backup data before reusing the duplicate's media. Specif^' this 
field by using the following format, repeating it as many times 
as necessary to configure expirations for your site: 

Note; If you identify more than one trail For a particular 
level, the last specification overrides the others, 
keep duplicates of level n for: time-period; 

where: 

• n specifies the backup level(s) of the duplicate, to wliich 
the setting applies (0-9). 

» time-period defines the amount of time to retain the dupli- 
cates for this level, specified as an integer followed by an 
appropriate units value. 

Note: Refer lo"Keep ISackups" on page B-65 for mcjrc 
infornration about these fields. 

You can expire duplicates immediately: 

keep duplicates of level 2 for: 1 secc.nd; 

Or keep them indefinitely: 

keep duplicates of level 0 for: forever; 

You c-an combine the time units, as in the following example: 
keep duplicates of level 9 for: 1 year 6 months; 

Note: You must expire duplicate data before (or at the 

same time as) the corresponding backuj? data. Refer 
to "Rejecting a Mount Request" on page 9-29 for 
more infomiation. 
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Keep Backup Catalogs use Oiis field to indicate how long to keep the backup catalogs 

created for each level 0-9 backup. Always expire the catalogs 
before, or at the same time as, the media (above). 

The format of this field is: 

keep backup catalogs of level n for: time-period; 

Where n and time-period are specified as described alcove I'oj- 
Ihe keep backups setting. .Make sure tc^i cover e\'ery backup 
level u.sed. 

The recommended setting (and the initial value at installation) is 
1 year for level-0 backups, and 3 months for leA'els 1-9: 

keep backup catalogs of levels 0-9 for: 3 months; 
keep backup catalogs of level 0 for: 1 year; 

Note: If you idenlif)' more llian one expiration for a 

panicular level, the last specificalion ovcnides the 
otliers. 

You should expire the catalogs for incremental backups aggres- 
sively to free up disk space, because; 

1 . You j-arely restore files from older incremental backups and 

2. You can reconstruct the catalogs from the iiackiqxs, if 
necessary 

If you omit tliis field, it defaults to forever. 

Note: See Chapter 10 "Magnetic Disk Concepts". 
Changes to this field lake effect immediately, but don't affect 
any currently ninning work items. 



Keep Saveset Records use this field to indicate how long to keep the saveset records 

created for work items written to this trailset. Saveset records 
ai-e necessaiy during a restore, to locate backup data and 
catJilogs. Because of this, you can't generally expire saveset 
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l ecoids before either ihe backup data or the catalogs. An 
exception occurs if you specifs' keep backups forever, in wliicli 
case you can expii'e tlie savesct record. 

The format of this field is: 

keep saveset records of level n for: time -period; 

Where n and lime-period are specified as described above for 
the keep backups setting, except that you can speciiy Bl and 
B2 as well as levels 0-9. Make sure to cover cvci-y backup level 
used. 

The recommended setting (and the initial value at installation) is 
1 year for level-O and baseline backups, and 3 months for levels 
1-9: 

keep saveset records of level 0 for: 1 year; 
keep saveset records of level Bl for: 1 year; 

Note: If you identift' more than one expiration for a 

panicular level the la.si specification overrides the 
others. 

If you omit tliis field, it defaults to foremr. 

Changes to tliis field take effect immediately, but don't affect 
any currently running work items. 



Backup Catalog Delta Level U.se this field to specify the backup level at which you want 
EDM Backup to consolidate catalogs (1-9). 'Hie recommended 
setting (and the initial value at installation) is 9; 

backup catalog delta level; 9 

If you omit this statement, the backup catalogs are consolidated 
at level 1. 

Wlien EDM Backup consolidates the catalogs, it turns all the 
catalogs for the level specified — as well as any numerically 
higher levels — into deltas, which only contain information that 
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differs from the more recent catalogs. If you specify a delta level 
of 5, EDM Backup compresses the catalogs for level 5-9 
liackups. 

EDM Backup lecreales the full cxttalog from a delta as necessary 
during a restore, by adding back the information that %'as origi- 
nally compressed out. It uses as input all subsequent catalogs 
fo)- tlie work item, up to (and including) the most recent 
catalog. 

The latest catalog for any particular work item is always uncom- 
pressed, to provide fast access during restore processing. For 
the same reason, level-0 catalogs are always uncompressed. 

Changes to this field take effect immediately, and could affect 
NA'ork items currently being backed up, hut not any whose 
catalog is currently being processed. Since this field is used by 
catalog processing after backup processing, it should take effect 
on the next catalog to .start being processed by ebcatalogd and 
ebcatd. ITiis could be the cui-rently running work items, since 
their catalogs have not been processed yet. 



BflCkUP TOmplBtG Fields a backup schedule template describes how to back up a group 
of clients, grouping together work group(s) and trailsets. You 
can have as many backup schedule templates as you want, but 
you must have at least one. The template specifies: 

• The list of work group(s) to back up. 

• The rotation period to use and date to start the first rotation. 

• The trailsetCs) on which to .store the backup daut for clients 
in the work group(s). Each backup template has a primmy 
trailset, and may have an optional alternate trailset. 
Generally die alternate trailset is used foj- off-site storage. 

• \XTiether to force all baseline backups to fini,sh before any 
level 0-9 backu]3s can start (available only if you've 
purchased HSM). 
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• Whethej- to recreate tlie baseline backup if necessaiy 
(a\'ailable only if you've purchased HSM). 

• Information about the log files and completion reports. 

• Scheduling specifications. 

Specify the template fields as described in the sections that 
follow. 



Backup Template Name Specif\' this field as the l-63 character name lor the template: 

backup template: "template name" 

Note: The template name field does not end with a 

semicolon, but is followed by a brace-delimited 
L)lock that defines its specifications. 

The lemplale name must be unique wiihi]i tlie configuration 
file. You'll reference the template name when you invoke 
ebbackup to start a l^aclcup. 
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backup template: "sales-all" 

\ 

work group list: "sales", "local"; 

begin trailset rotations on: Dec 13, 1993; 

rotation period; 7 days; 

primary trailset: "on site 1", use new volume on 
each rotation; 

alternate trailset: "off site 2", use new volume on 
each rotation; 
logging level: stats; 

server logfile; "sales-all_template.log", 256k; 
backup completion script: "mailok"; 
backup failure script: "mailerr"; 

do all baseline backups before normal backups; 
recreate baseline if needed; 

{ 

/* standard rotations; */ 
/* full during weekends rotations; */ 
vjeekday backup shift is 8 hours; 
weekend backup shift is 24 hours; 
level 9 on Monday, Tuesday, Wednesday, Thursday, 
Friday; 

for "sales", level 0 on Saturday; 
for "local", level 0 on Sunday; 



Note: If you remove a template from the configuralion 
file, it remains in the schedule, as do any work 
items scheduled for that template. To remove a 
template completely, first remove it from the config- 
uration file, tiien use ebbackup with the -retire 
option to delete it from the schedule. 

Changes to die template name take effect the next time 
ebbackup processing runs. 
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Work Group List use the ivork group list to specify the work groui^s that are 

backed up together using this template. Tliis is a shoithand 
method of identifying each work item individuaJly. See "Work 
Group Fields'' on page B-31 for information about defining 
woi'k groups. 

The format of this field is: 

vjork group list: "work group", "work group", 
..." work group" ; 

Changes to this field take effect the next time ebbackup 
processing runs. 



Begin Trailset Rotations This field specifies when EDM Backup should begin using the 

template (for a new template, it defaults to the dale the template 
is added). It apj^lies for all work items in the temjDlate, and for 
botli automatic and custom sclieduling (but not for command- 
line scheduling). 

If you want to create a new template^ but do not want to start 
using it yet, use this field with the data w'hen the template is to 
be used. The format of this field is: 

begin trailset rotations on: date; 

Where date takes one of three formats: 



Format 


Example 


dd-inmm-^7 


13-dec-99 


mnvdd/y\' 


12/1.V99 


mmm dd, yy 


Dec 13, 99 


iiimm dd, yyyy 


Dec 13, 19.99 


Leading zeros are not required. EDM Backup interprets the 
cenaiiy using standard UNfX conventions: 
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» Years in the range 70-99 are in tJie 20th century (i.e., 19i;)') 
» Years in the range 0-37 are in the 21st centuiy (i.e., 20>;)') 
• Years in tlie range 38-69 are illegal — EDiM Backup can't 

ci'eate timestamps for these years i3ecaiisc of a UNIX 

restiiction 

Clianges to this field take effect tlie next time EDM Backup 
schedules work items. 



Rotation Period TItIs field indicates how often each client should receive a level 

0 backup (autocoiifigured to every 14 days). For automatic 
scheduling, it's used by EDM Backup to compute the schedule 
of level 0 and level 9 backups, ensuring at least one level 0 
backup during each rotation. For custom sclieduling. it sen'es as 
the point of refei-ence when defining die backup schedule (foi' 
example, run level 0 backups on the 1st day of each rotation, 
and run level 9 backups on days 4, 8, and 12). 

The rotation period also indicates when EDM Backup should 
start a new media rotation for the template. By default, F:DM 
Backup starts writing to a new set of media on day 1 of each 
new rotation. You can oveiride this either in the statement that 
defines what trailsets to use (described under "Primary and 
Alternate Trailsets'' on page B-73), or on the command line, 
wlien you run ebbackup, 

Tiie format of this field is shown below: 
Wliere: 

• 11 is any integer greater tlian 1 . The most common rotation 
periods are 7 days, 14 days, or 28 days. For automatic 
scheduling: 

Use a 7-day rotation if restore time is important and you 
can afford the resources necessaty to maintain a full 
backup every seven days. 
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Use a 14-day rotation (the installation default) unless 
you have a good reason to use a different setting. The 
] 4-day rotation consen'es media and generally offers a 
good restore rate. 
- Llse a 28-day rotation to minimize the use of l")ackup 
media, or for filesystems tlial change little over time 
(such as / and /usr). Restoiing files will he slowest with 
this schedule, because there may be more incremental 
backups to read; however, the effect should be minimal 
if your datii changes little over lime. 
» time-units defines die unit of time in which the rotation 
period is specified: 

Units 

day(s) 
week(sj) 
month(s) 
year(s) 



f'or example, to automatically perform a full backup eveiy 7 
days on the clients named by the work group, enter; 
rotation period: 7 days; 

Changes to this field take effect die next time EDM Backup 
schedules work items. 



Primary and Alternate a template must specify one traiiset, and can specify tv>'o, 

TrailSetS known respectively as ihcprimaiy and aJteriiate irailsels. 

Specify the trailset(s) using tliis format; 
primary traiiset: "traiiset name", 
use new volume on each rotation; 

use nev! volume on each rotation; 
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Whei-e; 

* The traiJset name identifies the trailsel to which backups 
are written, and must 8]3ecily a name tiiat's defined already 
in tiie configuration file (set to "primary" at installation). 

» The clause use new i-'ohtme on each rotation directs EDM 
Backup to start a new volume(s) at tlie teginning of each 
rotation period. This separates backups fi-om different 
rotation periods into distinct volume sets. 

If you specify an alternate trailset, EDM Backup switches 
between tlie two trailsets each day, scheduling the primaiy 
trailset on odd-numbered days with respect to the template's 
romtion period, and the alternate trailset on even-num1iei-ed 
days. Witli automatic scheduling, this provides a second 
separate set of backups on alternating nights. If the rotation 
pej'iod specifies an even number of days, the two sets of 
backups are nearly the same, differing only by one day's worth 
of data. 

With custom scheduling it can do the same, but if s up to you to 
schedule identical backups on alternating days. If you specifs'- 
an alternate trailset with custom sclieduling, make sure to 
define two complete (and exact) schedules, running tlie same 
level on each of two consecutive days. By scheduling the 
following levels to run on the days shown, you'll create two 
identical trailsets tliat differ by one day's worth of cUita. 



Day 


Level 


Trailset Used 


Monday 


0 


Primary 


Tuesday 


0 


Alternate 


Wednesday 


9 


I'rimary 


'I'hursday 


9 


.Alternate 


Saturday 


9 


Primaiy 


Sunday 


9 


Allernalf 
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Yoii can spread out tlie backups more, as long as you specify 
one of the two identical backups on an e\en day with respect 
to tlie rotation cycle, and one on an odd day. 

Changes to this field take effect the next time ebbackup 
processing runs. 



Use this field to specify the level of loggino messages written to 
the file specified via the server log file field when this template 
is backed up. 

Specify tlie logging level using tliis format: 

logging level: logging level; 

\X'hei-e logging Jeuel is specified as follows (defaults to slats at 
installation). 



Code Description of Messages Logged 

none No me.ssages. 

errors Logs erroi's, including device and communication erroj s, 

stats Logs statistics as well as the information for the errors level 
The statistics include the amount of data saved, the time it 
took to save tlie data, when the backup started and 
finished, and so on. 

debug Logs debugging infonnation as well as tlie information tor 
the stats level. Only use tliis level at the direction of 
customer support. 

pei- file Logs several lines, including debug-\e\e\ information, for 
each file that's backed up. Only use this level at the 
djj-ection of customer support. It slows backup ihrougliput 
and can result in a liuge log file. 



Changes to tliis field take effect immediately, but don't affect 
any currently running work items. 
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Server Log File use this field to specify the name and maximum size of the 

template's log file. This file is stored on the server as 
/usr/epoch/EB/log,{/^te-»i37r;e and i-ecoi-ds infoimation as 
directed by the logging level field. It provides an audit trail of all 
backup activities for the template. 

The format is: 

server logfile: "Jog file name", file-si ze; 
Where: 

• logJUe name identifies the log file on the server (stored in 
the /usr/epoch/EB/log directoiy, set initially to 
defauli_template.log, where ■■default" is tJie template name). 
You can create a diffei-ent log file for each template or you 
can share a single log file across ail templates. If you specify 
a separate log file for each template, use a name that 
identifies the template. 

«• file-size indicates hov*' large tlie file can get befoi-e tlie 
oldest data is expired. Wlien ilie file j-eaches the specified 
size, EDM Backup locates the oldest data in the file and 
expires 10 percent of that data to free up space for new 
information. Specify this field as a number of bytes 
followed by a unit code (e.g., 500KB, set to 256K at instal- 
lation). Specif^' the unit code as follows: 



Unit Code 


Measure 


k, K, kb, or 1<B 


kilob\tes 


m, M, mb, or MB 


megabytes 


g, G, gb, or GB 


gigabytes 



To allow the file to grow until it's as large as pemiitted by 
physical storage space, specify no limit (and no otlier options). 
By not setting a limit on the file, it becomes a permanent audit 
trail of backup opei^ations for the template: 
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server logfile: "def ault_^template . log" , no limit; 

Note: U' you don't liniil tlie file size, ii may become too 
large to manage. Also, in HSM systems it woni be 
staged. 

Tliis example logs messages for llie sales-all template, and has a 
maximum file size of 256KB: 

server logfile: "sales-all_template.log", 256KB; 

If yoLi omit tliis setting, no log file is maintained for the 
template. 

Changes to tliis field take effect immediately, but don't affect 
any currently-running work items. 



Backup Completion Script ED.M Backup generates completion reports describing each 

successful backup. There is one completion report per template. 
EDM Backup forwards these reports to the script file indicated 
using this parameter. The script file, in turn, dispatches the 
rc-ports according to how the script is defined. 

As installed, EDM Backup directs completion reports to 
the supplied "mailok" script on die sender 
(/usr/epoch/'HB/config,''mailok). Depending on how that script 
is defined, it sends the reports to .specific administrators 
(generally those defined in the list of backup administrator 
usernames), to the log file, or to both. 

You can change the script by entering a new script name in the 
Advanced Options popup window in the Schedule lab of the EDM 
Backup Configuration window. 

If you specif).' a relative pathname, the file is assumed to be in 
/usr/cpoch/EB/config. If you specify an absolute pathname, tlie 
file can be locjited an^'Vi'here. 

For a sample report, see "Backup Completion Repoits" on page 
16-29. 

If you this setting is blank, no completion reports are generated. 
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Changes to tliis field take effect immediately 



Backup Failure Script F.DM Backup creates backup failure repons for each work item 

NA'hose backup fails. It forwards these reports to tlie script file 
indicated using this parameter. The .script file, in airn, 
dispatches the reports according lo how tlie script is defined. 

By default, liDM Backup directs failure reports to the EDM- 
supplied ''mailerr" script on the sen-er 

{/usr/epoch/EB/config/''mailerr). Depending on liow that script 
is defined, it mails tlie ]-epoi'is to specific administrators 
(generally those defined in tlie list of backup administrator 
usernames), to the log file, or to both. 

You can change the script by entering a new script name in the 
Advanced Options popup window in the Schedule tab of the EDM 
Backup Configuration window. 

If you specify a relative pathname, the file is assumed to be in 
/usr/epoch/EB/config. If you .specify an absolute pathname, the 
file can be located anyT\'here. 

For a sample report, sec "Backup Failure Reports" on page 
16-31. 

If this setting is blank, no failure repoits are generated. 

Note: You can leave this field blank to reduce the aniounl 
of EDJ\1 Backup mail. Tlie lockup completion script 
(niailoM) reports include all types of activity, 
including failures. You can refer there for infor- 
mation about failures. 

Changes to this field take effect immediatch'. 



Do All Baseline Backups i se this statement if you've purchased HSM, and want to ensure 

Before Normal Backups that all baseline backups finish for the template belbre the level 

0-9 backups slait for any work items backed up by the 

template: 
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do all baseline backups before normal backups; 

Tliis feature is useful when baseline backups consume most of 
tJie server's j-esourccs, which can happen if significant amounts 
of magnetic disk space are required to hold temporaiy files, li 
can also alleviate disk tlirasliing. On the downside, il can slow- 
overall throughput. 

With tliis statement omitted (ihe default at installation), EDM 
Backup finishes the baseline backup for each work Hem befoi'e 
starting the level 0-9 backup for that same work item. 

Note: This specification applies for custom and automatic 
scheduling, but is not used for command-line sched- 
uling. 

Clianges to tltis field take effect the next time ebbackup 
processing runs. 



Recreate Baseline if Needed include this statement if you've purchased HSM, and you w ant 
to automatically re-baseline any file for which the existing 
baseline copy was substituted for the staged copy during a 
restore; 

recreate baseline if needed; 

If you don't want to re-baseline files automatically, use the 
following statement instead (or don't include either statement). 
This is die default setting at installation: 

do not recreate baseline if needed; 

If you choose to re-baseline files automatically, ebbackup 
checks each file when it ams a baseline baclaip, to see if the 
staging id in the file's extended inode is the same as the 
baseline id. These two ids are only the same if the baseline 
copy of the file was substituted for a missing (or damaged) 
staged version. If the ids are tlie same, ebbackup automatically 
generates a new baseline copy of die file, then updates the 
baseline id so that it points to the new copy. 
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Changes to this field take effect the nexi time ebbackup 
processing runs. 



Schedule Hie schedule tells EDM Backup when to run backups for the 

template, and how much time to commit to backup pi'ocessing 
eacli day. For custom scheduling, it defines when to run each 
backup level (and optionally, when to run each level for a 
specific ivork group). 

Some scheduling options apply for automatic scheduling and 
some foi' custom scheduling, as follows: 



Table B-6 Scheduling Fields 

Option Applicable for: 

Automatic Custom 

Standard rotations 
Full during weekends rotations 
Weekday backup shift 
NX'eekend liackiip sliift 
Ifor ivork-groiip-nanie] level n on days 



The schedule block looks like this: 

schedule: 
{ 

I* standard rotations; */ 
/* full during weekends rotations; */ 
weekday backup shift is 8 hours; 
weekend backup shift is 24 hours; 
level 9 on Monday, Tuesday, Wednesday, Thursday, 
Friday; 

for "sales", level 0 on Saturday; 
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for "local", level 0 on Sunday; 

Note: A level map takes precedence over any scheduling 
defined using tliis block. For example, if you'd 
normally create one level 0 backup and the resi 
level 9 backups during ihe rotation (as for automatic 
scheduling), but a work item specifies a level map 
of "BBOOOOOOOOOO", each level 0-9 backup for that 
work item will run as a level 0 backup. 

Specif^' each field as described below, hi general, tn' to 
schedule bacl\ups when system use is low. 



Standard vs. Full-During-Weekends Most sites let EDM Backup schedule backups automatically, 
Rotations based on the settings in the configuration file. If thi.s is the case 

at your site, choose one of tliese two scheduling directives to: 
•> Turn on automatic scheduling ^selecting either directive 
does this). 

• Specify how U) perform backups. Indicate the .statement 
you want by placing comment markers (,/* . . . '/') around the 
other statement; 

standard rotations; 

/* full during vjeekends rotations; */ 



Specification Description 

Standai'd rotations Schedules backups so that some portion of 
tl)e clients receive a full backup each day 

l^uU during Schedules back-ups so that all clients that 

weekends rotations i-equire a full liackup receive that backup on 
Saturday oj- ,Sunday, when possible, with 
any ina-ementals ainning on weekdays 



Changes to tliis field lake effect the next lime EDM Backup 
schedules work items. 
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Specifying Backup Shifts !f you're using automatic scheduling, use these t^'o fields to 

indicate how mucli time you want to allow EDM Backup to run 
eacli day. lliis serves as a guideline, or goal, wlien UDM 
Backup schedules the work items for backup. Specify the time 
for each weekckty (Monday-Friday,), then for each weekend da)' 
(Saturday and Sunday): 

weekday backup shift is hh hours nun minutes; 
v.'eekend backup shift is hh hours mm minutes; 

Specify hh as a number of hours (an integer in the range 1-24), 
and mm as a number of minutes (1-60; include only if 
necessary); 

weekday backup shift is 8 hours 30 mi.nutes; 
weekend backup shift is 24 hours; 

Note: The backup shift specifications are not bindijig, IduI 
ser\'e only as a target fo]' the amount of time 
committed to backup processing each day. 

Changes to tliis field take effect the next time ebbackup 
processing runs. 



If you're scheduling custom backups, use this statement to: 
• Turn on custom scheduling (happens automatically when 
you include one or more cu.stom-.scheduling statements and 
you omit bofli statements used to turn on automatic sched- 
uling) 

» Define when you want to nm the backups, repeating this 
statement as necessajy to configure your site: 
[ for "work-group-name"] level n on [day(s)j 
days; 

You c:an specify each work group individually, or you can 
combine tlie work groups for die template into a single 
statement. You might want to combine the work groups for one 
or more leveKs), but separate them for another level(s): 
level 9 on Monday, Tuesday, Wednesday, Thursday, 



Scheduling Custom Backups (Level n 
on Days...) 
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for "sales", level 0 on Saturday; 
for "local", level 0 on Sunday; 

Specify each syntax field as follows: 

• The for work-group-name clause applies if the statement is 
for a specific work group, and specifies the name of the 
work group exactly as it appears in the template's work- 
grou]5 list (defaults to all work groups in that list ii' you omit 
this clause). If two statements apply for the same woj-k 
group, EDM Backup uses the most restrictive specification 
(the one that's specific to Ore work group). You might use 
one .stiUement to schedule all work groups, then add state- 
ments for each exception to the ''rule": 

level 9 on days 1-14; 

level 0 on days 7, 14; 

for "sales", level 0 on day 1; 

• llie level n clause identifies the backup level you want to 
run on the day(s) specified (0-9, Bl, or B2). If more llian 
one level is specified for the same day, EDM Backup 
perfomis tlie lowest level, numerically (e.g., le\'el 0 instead 
of level 5). 

If tlie template specifies an alternate trailset, make sure to 
schedule two level-0 backups for each work group — one 
on an even-numbered day and one on an odd-numbered 
day, with respect to die rotation cycle. (Remembei- tliat the 
two trailsets arc backed up on alternating days.) 

Note: Specify ba.seline backups explicitly, EDM Backuji 
does not run baselines automatically vi-hen you u.se 
custom scheduling. 

» days indicates the days on which you want to run backups 
for tliis level (and optionally, for this work group). 
If you don't request backups for a particular day, EDM 
Backup won't ]Derform backups on that day (for this 
template). 
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Note: If you schedule tuslom backups, don'l specifx- 
either of llie directives for aulonialic scheduling 
(described under "Specifying Backup Sliifis" on 
page B-84). This causes an error. 

Specify the days as follows: 



Days Description 
Specification 

a single integer To represent that day in the i'otaiian period (1 for 
the first day, 2 ibi' tlie second day, and so Ibnh u]3 
to the number of days specified in tlie rotation 
period for the template). 

a range of To represent a range of days in tlie rotation period 

integers only for a rotation period this is NOT a multiple of 7 
clays long (e.g., 1-6 for days 1. 2, 3. 5, and 6). 

name of dayCs) To represent a specific day of tlie weel< (that is, for 
a rotation period of 7 days or a multiple of 7 days 
long). Spell out the full name nf ilie day (Saairday, 
Sunday, etc.). You cannot specily a range of names 
— each day mu.st he listed separately. 

You can describe a S]3ecific occurrence of a day 
within the rotation period, by prefacing tlie day 
with a number (2nd Saturday. 3rd Monday, etc.). 



Changes to tliis field take effect the next titne EDM Backup 
schedules work items. 



Startup Parameters Use the staraip parameters block to specify when to perform 

the first (level 0) backup for a new client. It's important to 
perfcjrm the first level 0 backup as soon as possible, because no 
incrementals run until tlie first level-0 backup is performed. 

This block applies for automatic scheduling only, and is ignored 
with custom scheduling. It looks like this: 
startup parameters: 
{ 

perform initial full backup on scheduled day; 
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/* perform initial full backup as soon as possible; 
* / 

Specily one of die following in the EDM Backup Configuration 
window: 

• Specify pe?-/brfn initial full backup on scheduled day to 
perform tlie initial full backup on some portion of the 
newly-installed clients each day during flie first rotation 
period. Tliis setting distributes the work load as evenl)' as 
possible across the rotation period, and is the I'ecom- 
mended (and initially configured) approach. By the end of 
the first rotation, every client will have a level-0 backup. 

» Specify' perform initial full backup as soon as possible to run 
the initial full backup on all newly-installed clients during 
the first backup am after those clients are installed. When 
you use this option, EDM Backup perlbnns initial full 
backups on every new client, one aftej- tlie other. The 
impact on the system is dicUited by the total amount o!' 
client data that needs to be liacked up. 

You may want to specify' perform initial full backup on 
scheduled day when you first configure your system, then 
change it to perform initial full backup as soon as possible after 
the initial backups are taken (for use as new clients are added). 

With either method, the client gets backed up according to its 
normal rotation schedule after the initial level-O backup is 
completed. 

Note: This specification only applies for the first backup 
that's mn after a client is installed. It has no effect 
on subsequent processing. 

Changes to the startup parameters block utke effect the next 
time backup scheduling occurs. 
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